feat: add agent response logging

apps/freya-backend/package.json

@@ -33,6 +33,8 @@
 		"drizzle-orm": "^0.45.1",
 		"hono": "^4",
 		"lodash.merge": "^4.6.2",
+		"pino": "^10.3.1",
+		"pino-pretty": "^13.1.3",
 		"typebox": "^1.1.38"
 	},
 	"devDependencies": {

apps/freya-backend/src/agent/job.ts

@@ -10,11 +10,13 @@ import { type } from "arktype"
 
 import type { ConversationStorage } from "../conversations/storage"
 import type { Job } from "../lib/job"
+import type { AppLogger } from "../lib/logger"
 import type { JobExecutor } from "../lib/worker"
 import type { NotificationCentral } from "../notification/notification-central"
 import type { UserSessionManager } from "../session"
 
 import { ConversationResponseStateStatus } from "../db/schema"
+import { logger as rootLogger } from "../lib/logger"
 import {
 	AgentResponseStreamEventKind,
 	streamAgentResponse,
@@ -27,61 +29,93 @@ export interface AgentResponseJobPayload {
 
 interface AgentResponseWorkerConfig {
 	conversationStorage: ConversationStorage
+	logger?: AppLogger
 	userSessionManager: UserSessionManager
 	notificationCentral: NotificationCentral
 }
 
 export class AgentResponseJobExecutor implements JobExecutor<AgentResponseJobPayload> {
 	private conversationStorage: ConversationStorage
+	private logger: AppLogger
 	private userSessionManager: UserSessionManager
 	private notificationCentral: NotificationCentral
 
 	constructor({
 		conversationStorage,
+		logger,
 		userSessionManager,
 		notificationCentral,
 	}: AgentResponseWorkerConfig) {
 		this.conversationStorage = conversationStorage
+		this.logger = logger ?? rootLogger.child({ component: "agent_response_job" })
 		this.userSessionManager = userSessionManager
 		this.notificationCentral = notificationCentral
 	}
 
 	async execute(job: Job<AgentResponseJobPayload>): Promise<void> {
-		const conversation = await this.conversationStorage.findConversation(job.payload.conversationId)
+		const conversationId = job.payload.conversationId
+		const startedAt = Date.now()
+		const logger = this.logger.child({ conversationId, jobId: job.id })
+
+		logger.info("agent response job started")
+
+		const conversation = await this.conversationStorage.findConversation(conversationId)
 		if (!conversation) {
+			logger.warn("conversation not found for agent response job")
 			return
 		}
 
-		const claimed = await this.conversationStorage.claimPendingConversationResponseState(
+		const claimed =
-			job.payload.conversationId,
+			await this.conversationStorage.claimPendingConversationResponseState(conversationId)
-		)
 		if (!claimed) {
 			// conversation response state not found or already claimed
+			logger.debug("agent response state was not claimable")
 			return
 		}
 
+		try {
 			const pendingEntries = await this.conversationStorage.listPendingUserConversationEntries(
 				conversation.userId,
 				conversation.id,
 			)
 			if (pendingEntries.length === 0) {
-			await this.conversationStorage.clearConversationResponseState(job.payload.conversationId)
+				await this.conversationStorage.clearConversationResponseState(conversationId)
+				logger.debug("agent response state cleared with no pending user entries")
 				return
 			}
 
+			let invalidPendingEntryCount = 0
 			const message = pendingEntries.reduce((acc, entry) => {
 				const payload = UserMessagePayload(entry.payload)
 				if (payload instanceof type.errors) {
+					invalidPendingEntryCount += 1
 					return acc
 				}
 				return (
-				acc + "\n" + payload.parts.reduce((msg, p) => (p.type === "text" ? msg + p.text : msg), "")
+					acc +
+					"\n" +
+					payload.parts.reduce((msg, p) => (p.type === "text" ? msg + p.text : msg), "")
 				)
 			}, "")
 
+			logger.debug(
+				{
+					invalidPendingEntryCount,
+					messageLength: message.length,
+					pendingEntryCount: pendingEntries.length,
+				},
+				"agent response pending user entries loaded",
+			)
+
+			if (invalidPendingEntryCount > 0) {
+				logger.warn(
+					{ invalidPendingEntryCount },
+					"invalid pending user entries skipped for agent response",
+				)
+			}
+
 			const session = await this.userSessionManager.getOrCreate(conversation.userId)
 
-		try {
 			for await (const event of streamAgentResponse({
 				agent: session.agent,
 				input: {
@@ -94,21 +128,36 @@ export class AgentResponseJobExecutor implements JobExecutor<AgentResponseJobPay
 					break
 				}
 
-				await this.handleStreamEvent(event, conversation.id, conversation.userId)
+				await this.handleStreamEvent(event, conversation.id, conversation.userId, logger)
 			}
 
 			// if job is aborted, stop everything immediately, including clean up.
 			// the aborter is assumed responsibility on how to proceed.
 			if (!job.signal.aborted) {
-				await this.conversationStorage.clearConversationResponseState(job.payload.conversationId)
+				await this.conversationStorage.clearConversationResponseState(conversationId)
+				logger.info({ durationMs: Date.now() - startedAt }, "agent response job completed")
+			} else {
+				logger.warn({ durationMs: Date.now() - startedAt }, "agent response job aborted")
 			}
 		} catch (err) {
-			console.error("[agent job executor] error streaming agent response:", err)
+			const durationMs = Date.now() - startedAt
-			if (!job.signal.aborted) {
+			if (job.signal.aborted) {
+				logger.warn({ durationMs, err }, "agent response job aborted")
+				return
+			}
+
+			logger.error({ durationMs, err }, "agent response job failed")
+			try {
 				await this.conversationStorage.markResponseStateStatus(
-					[job.payload.conversationId],
+					[conversationId],
 					ConversationResponseStateStatus.Failed,
 				)
+				logger.warn(
+					{ status: ConversationResponseStateStatus.Failed },
+					"conversation response state marked failed",
+				)
+			} catch (markErr) {
+				logger.error({ err: markErr }, "failed to mark conversation response state failed")
 			}
 		}
 	}
@@ -117,6 +166,7 @@ export class AgentResponseJobExecutor implements JobExecutor<AgentResponseJobPay
 		event: AgentResponseStreamEvent,
 		conversationId: string,
 		userId: string,
+		logger: AppLogger,
 	): Promise<void> {
 		switch (event.kind) {
 			case AgentResponseStreamEventKind.ConversationStarted:
@@ -127,6 +177,13 @@ export class AgentResponseJobExecutor implements JobExecutor<AgentResponseJobPay
 						conversationId: event.conversationId,
 					},
 				})
+				logger.debug(
+					{
+						eventKind: event.kind,
+						upstreamConversationId: event.conversationId,
+					},
+					"agent conversation started",
+				)
 				break
 
 			case AgentResponseStreamEventKind.AssistantMessage: {
@@ -144,6 +201,14 @@ export class AgentResponseJobExecutor implements JobExecutor<AgentResponseJobPay
 						entry,
 					},
 				})
+				logger.debug(
+					{
+						entryId: entry.id,
+						eventKind: event.kind,
+						textLength: event.text.length,
+					},
+					"agent assistant message persisted",
+				)
 				break
 			}
 
@@ -161,6 +226,14 @@ export class AgentResponseJobExecutor implements JobExecutor<AgentResponseJobPay
 						entry,
 					},
 				})
+				logger.debug(
+					{
+						entryId: entry.id,
+						eventKind: event.kind,
+						toolName: event.toolName,
+					},
+					"agent tool call persisted",
+				)
 				break
 			}
 
@@ -179,6 +252,15 @@ export class AgentResponseJobExecutor implements JobExecutor<AgentResponseJobPay
 						entry,
 					},
 				})
+				logger.debug(
+					{
+						entryId: entry.id,
+						eventKind: event.kind,
+						ok: event.ok,
+						toolName: event.toolName,
+					},
+					"agent tool result persisted",
+				)
 				break
 			}
 
@@ -190,6 +272,7 @@ export class AgentResponseJobExecutor implements JobExecutor<AgentResponseJobPay
 						conversationId,
 					},
 				})
+				logger.info({ eventKind: event.kind }, "agent response finished")
 				break
 
 			case AgentResponseStreamEventKind.ResponseFailed:
@@ -201,6 +284,10 @@ export class AgentResponseJobExecutor implements JobExecutor<AgentResponseJobPay
 						error: event.error,
 					},
 				})
+				logger.warn(
+					{ agentError: event.error, eventKind: event.kind },
+					"agent response failed event received",
+				)
 				break
 		}
 	}

apps/freya-backend/src/agent/reconciler.ts

@@ -1,9 +1,13 @@
 import type { ConversationStorage } from "../conversations/storage"
+import type { AppLogger } from "../lib/logger"
 import type { AgentWorkScheduler } from "./scheduler"
 
+import { logger as rootLogger } from "../lib/logger"
+
 interface AgentResponseReconcilerConfig {
 	storage: ConversationStorage
 	interval: number
+	logger?: AppLogger
 	scheduler: AgentWorkScheduler
 	signal: AbortSignal
 }
@@ -11,20 +15,23 @@ interface AgentResponseReconcilerConfig {
 export class AgentResponseReconciler {
 	private storage: ConversationStorage
 	private interval: number
+	private logger: AppLogger
 	private scheduler: AgentWorkScheduler
 	private signal: AbortSignal
 
 	private stopLoop: ReturnType<typeof setInterval> | null = null
 
-	constructor({ storage, interval, scheduler, signal }: AgentResponseReconcilerConfig) {
+	constructor({ storage, interval, logger, scheduler, signal }: AgentResponseReconcilerConfig) {
 		this.storage = storage
 		this.interval = interval
+		this.logger = logger ?? rootLogger.child({ component: "agent_reconciler" })
 		this.scheduler = scheduler
 		this.signal = signal
 	}
 
 	start() {
 		this.signal.throwIfAborted()
+		this.logger.debug({ intervalMs: this.interval }, "agent response reconciler started")
 
 		this.signal.addEventListener(
 			"abort",
@@ -32,20 +39,32 @@ export class AgentResponseReconciler {
 				if (this.stopLoop !== null) {
 					clearInterval(this.stopLoop)
 					this.stopLoop = null
+					this.logger.debug("agent response reconciler stopped")
 				}
 			},
 			{ once: true },
 		)
 
-		this.stopLoop = setInterval(this.reconcile.bind(this), this.interval)
+		this.stopLoop = setInterval(() => {
+			void this.reconcile()
+		}, this.interval)
 	}
 
 	private async reconcile() {
+		try {
 			// enqueue pending responses
 			const pendingStates = await this.storage.listPendingResponseStates()
 			const now = new Date().getTime()
+			this.logger.debug({ pendingCount: pendingStates.length }, "agent response reconcile tick")
 			for (const state of pendingStates) {
 				if (state.maxWaitUntil.getTime() < now) {
+					this.logger.info(
+						{
+							conversationId: state.conversationId,
+							maxWaitUntil: state.maxWaitUntil.toISOString(),
+						},
+						"pending agent response reached max wait",
+					)
 					this.scheduler.enqueueAgentResponse(state.conversationId)
 				}
 			}
@@ -60,11 +79,22 @@ export class AgentResponseReconciler {
 					stuckIds.push(state.conversationId)
 				}
 			}
+			this.logger.debug(
+				{ runningCount: runningStates.length, stuckCount: stuckIds.length },
+				"agent response running states reconciled",
+			)
 			if (stuckIds.length > 0) {
 				await this.storage.markResponseStateStatus(stuckIds, "pending")
+				this.logger.warn(
+					{ conversationIds: stuckIds, count: stuckIds.length },
+					"stuck agent responses requeued",
+				)
 				for (const id of stuckIds) {
 					this.scheduler.enqueueAgentResponse(id)
 				}
 			}
+		} catch (err) {
+			this.logger.error({ err }, "agent response reconciliation failed")
+		}
 	}
 }

apps/freya-backend/src/agent/scheduler.ts

@@ -2,10 +2,19 @@ import type { UserEvent } from "@freya/agent-protocol"
 
 import type { ConversationStorage } from "../conversations/storage"
 import type { Job, JobRegistry } from "../lib/job"
+import type { AppLogger } from "../lib/logger"
 import type { AgentResponseJobPayload } from "./job"
 
 import { ConversationNotFoundError } from "../conversations/errors"
 import { ConversationResponseStateStatus } from "../db/schema"
+import { logger as rootLogger } from "../lib/logger"
+
+const AgentJobCancellationReason = {
+	NewUserActivity: "new_user_activity",
+	SupersededByEnqueue: "superseded_by_enqueue",
+} as const
+type AgentJobCancellationReason =
+	(typeof AgentJobCancellationReason)[keyof typeof AgentJobCancellationReason]
 
 interface AgentMessageSchedulerConfig {
 	storage: ConversationStorage
@@ -14,9 +23,10 @@ interface AgentMessageSchedulerConfig {
 	/**
 	 * How long to wait before responding to the user.
 	 */
-	waitTIme: number
+	waitTime: number
 
 	jobRegistry: JobRegistry<AgentResponseJobPayload>
+	logger?: AppLogger
 }
 
 /**
@@ -25,6 +35,7 @@ interface AgentMessageSchedulerConfig {
 export class AgentWorkScheduler {
 	private conversationStorage: ConversationStorage
 	private jobRegistry: JobRegistry<AgentResponseJobPayload>
+	private logger: AppLogger
 
 	private timing: {
 		maxWaitTime: number
@@ -37,9 +48,10 @@ export class AgentWorkScheduler {
 	constructor(config: AgentMessageSchedulerConfig) {
 		this.conversationStorage = config.storage
 		this.jobRegistry = config.jobRegistry
+		this.logger = config.logger ?? rootLogger.child({ component: "agent_scheduler" })
 		this.timing = {
 			maxWaitTime: config.maxWaitTime,
-			waitTime: config.waitTIme,
+			waitTime: config.waitTime,
 		}
 
 		this.jobRegistry.addEventListener("settled", this.eraseJob.bind(this))
@@ -50,9 +62,10 @@ export class AgentWorkScheduler {
 		const existing = this.timers.get(conversationId)
 		if (existing) {
 			clearTimeout(existing)
+			this.logger.debug({ conversationId }, "existing agent response timer replaced")
 		}
 
-		this.cancelCurrentJob(conversationId)
+		this.cancelCurrentJob(conversationId, AgentJobCancellationReason.NewUserActivity)
 
 		this.timers.set(
 			conversationId,
@@ -60,11 +73,22 @@ export class AgentWorkScheduler {
 				this.enqueueAgentResponse(conversationId)
 			}, this.timing.waitTime),
 		)
+
+		this.logger.info(
+			{
+				conversationId,
+				maxWaitMs: this.timing.maxWaitTime,
+				waitMs: this.timing.waitTime,
+			},
+			"agent response scheduled",
+		)
 	}
 
 	async receiveUserEvent(conversationId: string, event: UserEvent) {
 		if (event.type === "typing") {
+			this.logger.debug({ conversationId, eventType: event.type }, "user event received")
 			await this.delayAgentResponse(conversationId)
+			this.logger.debug({ conversationId }, "agent response delay handled")
 		}
 	}
 
@@ -73,18 +97,20 @@ export class AgentWorkScheduler {
 		if (existing) {
 			clearTimeout(existing)
 			this.timers.delete(conversationId)
+			this.logger.debug({ conversationId }, "agent response timer consumed")
 		}
 
-		this.cancelCurrentJob(conversationId)
+		this.cancelCurrentJob(conversationId, AgentJobCancellationReason.SupersededByEnqueue)
 
 		const job = this.jobRegistry.addJob({
 			payload: { conversationId },
 		})
 		this.runningJobs.set(conversationId, job)
+		this.logger.info({ conversationId, jobId: job.id }, "agent response job enqueued")
 	}
 
 	private async delayAgentResponse(conversationId: string) {
-		this.cancelCurrentJob(conversationId)
+		this.cancelCurrentJob(conversationId, AgentJobCancellationReason.NewUserActivity)
 
 		try {
 			const ok = await this.conversationStorage.transaction(async (storage) => {
@@ -102,14 +128,20 @@ export class AgentWorkScheduler {
 			})
 			if (ok) {
 				await this.scheduleAgentResponse(conversationId)
+			} else {
+				this.logger.debug(
+					{ conversationId },
+					"agent response delay skipped because response state is not pending",
+				)
 			}
 		} catch (error) {
 			if (error instanceof ConversationNotFoundError) {
 				// the user is typing but there isn't a scheduled agent response yet
 				// which means the user is typing their first message after the agent has previously responded
 				// swallow the error
+				this.logger.debug({ conversationId }, "typing event received without active conversation")
 			} else {
-				console.error("[agent response scheduler] error delaying agent response", error)
+				this.logger.error({ err: error, conversationId }, "agent response delay failed")
 			}
 			return
 		}
@@ -119,18 +151,26 @@ export class AgentWorkScheduler {
 	 * cancels the current job for agent response for the given conversation id
 	 * no-op if there is no active job for the conversation.
 	 */
-	private cancelCurrentJob(conversationId: string): void {
+	private cancelCurrentJob(conversationId: string, reason: AgentJobCancellationReason): void {
 		const job = this.runningJobs.get(conversationId)
 		if (!job) return
 
 		// If an active response is working on stale context, abort it so the next
 		// job can answer using the latest pending user messages.
 		this.jobRegistry.cancelJob(job)
+		this.logger.info(
+			{ conversationId, jobId: job.id, reason },
+			"active agent response job cancelled",
+		)
 	}
 
 	private eraseJob(job: Job<AgentResponseJobPayload>) {
 		if (this.runningJobs.get(job.payload.conversationId) === job) {
 			this.runningJobs.delete(job.payload.conversationId)
+			this.logger.debug(
+				{ conversationId: job.payload.conversationId, jobId: job.id },
+				"agent response job tracking cleared",
+			)
 		}
 	}
 }

apps/freya-backend/src/agent/service.ts

@@ -3,10 +3,12 @@ import type { UserEvent } from "@freya/agent-protocol"
 import { ConversationEntry, ConversationEntryKind, UserMessagePayload } from "@freya/core"
 
 import type { ConversationStorage } from "../conversations/storage"
+import type { AppLogger } from "../lib/logger"
 import type { NotificationCentral } from "../notification/notification-central"
 import type { UserSessionManager } from "../session"
 
 import { JobRegistry } from "../lib/job"
+import { logger as rootLogger } from "../lib/logger"
 import { Worker } from "../lib/worker"
 import { AgentResponseJobExecutor, type AgentResponseJobPayload } from "./job"
 import { AgentResponseReconciler } from "./reconciler"
@@ -22,50 +24,74 @@ interface AgentServiceConfig {
 	userSessionManager: UserSessionManager
 	notificationCentral: NotificationCentral
 	signal: AbortSignal
+	logger?: AppLogger
 }
 
 export class AgentService {
 	private readonly storage: ConversationStorage
+	private readonly logger: AppLogger
 	private readonly scheduler: AgentWorkScheduler
 	private readonly reconciler: AgentResponseReconciler
 	private readonly worker: Worker<AgentResponseJobPayload>
 
 	private readonly jobRegistry = new JobRegistry<AgentResponseJobPayload>()
 
-	constructor({ storage, userSessionManager, notificationCentral, signal }: AgentServiceConfig) {
+	constructor({
+		storage,
+		userSessionManager,
+		notificationCentral,
+		signal,
+		logger,
+	}: AgentServiceConfig) {
+		const baseLogger = logger ?? rootLogger
+
 		this.storage = storage
+		this.logger = baseLogger.child({ component: "agent_service" })
 		this.scheduler = new AgentWorkScheduler({
 			storage,
 			jobRegistry: this.jobRegistry,
-			waitTIme: AgentResponseTiming.waitTime,
+			waitTime: AgentResponseTiming.waitTime,
 			maxWaitTime: AgentResponseTiming.maxWaitTime,
+			logger: baseLogger.child({ component: "agent_scheduler" }),
 		})
 		this.reconciler = new AgentResponseReconciler({
 			signal,
 			storage: this.storage,
 			interval: 60 * 1000,
 			scheduler: this.scheduler,
+			logger: baseLogger.child({ component: "agent_reconciler" }),
 		})
 		this.worker = new Worker<AgentResponseJobPayload>({
 			signal,
 			concurrency: 10,
 			registry: this.jobRegistry,
+			logger: baseLogger.child({ component: "agent_worker" }),
+			jobFields: agentResponseJobFields,
 			runner: new AgentResponseJobExecutor({
 				conversationStorage: storage,
 				notificationCentral,
 				userSessionManager,
+				logger: baseLogger.child({ component: "agent_response_job" }),
 			}),
 		})
 	}
 
 	start() {
+		this.logger.info("agent service starting")
 		this.worker.start()
 		this.reconciler.start()
 	}
 
 	async scheduleAgentResponse(conversationId: string, message: string): Promise<ConversationEntry> {
-		const createdEntry = await this.storage.transaction(async (storage) => {
+		this.logger.info(
+			{ conversationId, messageLength: message.length },
+			"scheduling agent response from user message",
+		)
+
+		try {
+			const scheduledResponse = await this.storage.transaction(async (storage) => {
 				const now = new Date()
+				const maxWaitUntil = new Date(now.getTime() + AgentResponseTiming.maxWaitTime)
 
 				const entry = await storage.appendEntry(conversationId, {
 					kind: ConversationEntryKind.UserMessage,
@@ -76,20 +102,51 @@ export class AgentService {
 				})
 
 				await storage.upsertConversationResponseState(conversationId, {
-				maxWaitUntil: new Date(now.getTime() + AgentResponseTiming.maxWaitTime),
+					maxWaitUntil,
 					pendingSinceEntryId: entry.id,
 					status: "pending",
 				})
 
-			return entry
+				return { entry, maxWaitUntil }
 			})
 
+			this.logger.info(
+				{
+					conversationId,
+					entryId: scheduledResponse.entry.id,
+					maxWaitMs: AgentResponseTiming.maxWaitTime,
+					maxWaitUntil: scheduledResponse.maxWaitUntil.toISOString(),
+					waitMs: AgentResponseTiming.waitTime,
+				},
+				"agent response state set pending",
+			)
+
 			await this.scheduler.scheduleAgentResponse(conversationId)
 
-		return createdEntry
+			return scheduledResponse.entry
+		} catch (err) {
+			this.logger.error({ err, conversationId }, "failed to schedule agent response")
+			throw err
+		}
 	}
 
 	async handleUserEvent(conversationId: string, event: UserEvent) {
+		try {
 			await this.scheduler.receiveUserEvent(conversationId, event)
+		} catch (err) {
+			this.logger.error(
+				{ err, conversationId, eventType: event.type },
+				"failed to handle user event",
+			)
+			throw err
+		}
+	}
+}
+
+function agentResponseJobFields(job: {
+	payload: AgentResponseJobPayload
+}): Record<string, unknown> {
+	return {
+		conversationId: job.payload.conversationId,
 	}
 }

apps/freya-backend/src/agent/ws.ts

@@ -9,12 +9,17 @@ import { upgradeWebSocket, websocket } from "hono/bun"
 
 import type { AuthSessionMiddleware } from "../auth/session-middleware.ts"
 import type { ConversationStorage } from "../conversations/storage.ts"
+import type { AppLogger } from "../lib/logger.ts"
 import type {
 	NotificationCentral,
 	NotificationPayload,
 } from "../notification/notification-central.ts"
 import type { AgentService } from "./service.ts"
 
+import { logger } from "../lib/logger.ts"
+
+const agentWebSocketLogger = logger.child({ component: "agent_ws" })
+
 interface AgentWebSocketHandlerDeps {
 	agentService: AgentService
 	storage: ConversationStorage
@@ -60,7 +65,10 @@ export function registerAgentWebSocketHandlers(
 				onOpen(_event, ws) {
 					channel.attach(ws)
 					void connection.start().catch((err: unknown) => {
-						console.error("[query] Agent WebSocket JSON-RPC failed:", errorMessage(err))
+						agentWebSocketLogger.error(
+							{ err, conversationId: conversation.id },
+							"agent websocket JSON-RPC failed",
+						)
 						ws.close(1011, "Agent RPC connection failed")
 					})
 				},
@@ -82,6 +90,7 @@ class AgentRpcConnection implements AgentServerApi {
 	private readonly client: JsonRpcClient<AgentClientApi>
 	private readonly server: JsonRpcServer<AgentServerApi>
 	private readonly agentService: AgentService
+	private readonly logger: AppLogger
 	private readonly notificationCentral: NotificationCentral
 	private readonly userId: string
 	private readonly conversationId: string
@@ -103,6 +112,7 @@ class AgentRpcConnection implements AgentServerApi {
 	}) {
 		this.client = new JsonRpcClient<AgentClientApi>(channel)
 		this.agentService = agentService
+		this.logger = agentWebSocketLogger.child({ conversationId })
 		this.notificationCentral = notificationCentral
 		this.userId = userId
 		this.conversationId = conversationId
@@ -117,14 +127,19 @@ class AgentRpcConnection implements AgentServerApi {
 	}
 
 	notify(event: UserEvent): void {
-		this.agentService.handleUserEvent(this.conversationId, event)
+		void this.agentService.handleUserEvent(this.conversationId, event).catch((err: unknown) => {
+			this.logger.error({ err, eventType: event.type }, "failed to handle agent user event")
+		})
 	}
 
 	async sendMessage(message: string): Promise<ConversationEntry> {
 		try {
 			return await this.agentService.scheduleAgentResponse(this.conversationId, message)
 		} catch (error) {
-			console.error("[agent rpc connection] error when scheduling agent response", error)
+			this.logger.error(
+				{ err: error, messageLength: message.length },
+				"agent rpc schedule agent response failed",
+			)
 			throw error
 		}
 	}
@@ -239,7 +254,3 @@ class HonoWebSocketJrpcChannel implements JrpcChannel {
 		this.queue.push(msg)
 	}
 }
-
-function errorMessage(error: unknown): string {
-	return error instanceof Error ? error.message : String(error)
-}

apps/freya-backend/src/lib/logger.ts

@@ -0,0 +1,83 @@
+import { hostname } from "node:os"
+import pino, { type Logger } from "pino"
+
+export type AppLogger = Logger
+
+const LogLevel = {
+	Trace: "trace",
+	Debug: "debug",
+	Info: "info",
+	Warn: "warn",
+	Error: "error",
+	Fatal: "fatal",
+	Silent: "silent",
+} as const
+type LogLevel = (typeof LogLevel)[keyof typeof LogLevel]
+
+export const logger = pino({
+	base: {
+		hostname: hostname(),
+		pid: process.pid,
+		service: "freya-backend",
+	},
+	level: readLogLevel(process.env.LOG_LEVEL, process.env.NODE_ENV),
+	transport:
+		readLogFormat(process.env.LOG_FORMAT, process.env.NODE_ENV) === "pretty"
+			? {
+					target: "pino-pretty",
+					options: {
+						colorize: true,
+						ignore: "hostname,pid",
+						singleLine: false,
+						translateTime: "SYS:standard",
+					},
+				}
+			: undefined,
+	redact: {
+		censor: "[redacted]",
+		paths: [
+			"apiKey",
+			"authorization",
+			"cookie",
+			"credentialEncryptionKey",
+			"password",
+			"privateKey",
+			"*.apiKey",
+			"*.authorization",
+			"*.cookie",
+			"*.credentialEncryptionKey",
+			"*.password",
+			"*.privateKey",
+		],
+	},
+	serializers: {
+		err: pino.stdSerializers.err,
+	},
+})
+
+function readLogFormat(value: string | undefined, nodeEnv: string | undefined): "json" | "pretty" {
+	const normalized = value?.trim().toLowerCase()
+	if (normalized === "json") {
+		return "json"
+	}
+	if (nodeEnv === "test") {
+		return "json"
+	}
+	return "pretty"
+}
+
+function readLogLevel(value: string | undefined, nodeEnv: string | undefined): LogLevel {
+	const normalized = value?.trim().toLowerCase()
+	switch (normalized) {
+		case LogLevel.Trace:
+		case LogLevel.Debug:
+		case LogLevel.Info:
+		case LogLevel.Warn:
+		case LogLevel.Error:
+		case LogLevel.Fatal:
+		case LogLevel.Silent:
+			return normalized
+		default:
+			return nodeEnv === "test" ? LogLevel.Silent : LogLevel.Info
+	}
+}

apps/freya-backend/src/lib/worker.ts

@@ -1,25 +1,40 @@
 import type { Job, JobRegistry } from "./job"
-import type { Queue } from "./queue"
+import type { AppLogger } from "./logger"
+
+import { logger as rootLogger } from "./logger"
 
 export interface JobExecutor<JobPayload> {
 	execute(job: Job<JobPayload>): Promise<void>
 }
 
-export interface WorkerConfig<Job> {
+export interface WorkerConfig<JobPayload> {
 	concurrency: number
-	registry: JobRegistry<Job>
+	jobFields?: (job: Job<JobPayload>) => Record<string, unknown>
-	runner: JobExecutor<Job>
+	logger?: AppLogger
+	registry: JobRegistry<JobPayload>
+	runner: JobExecutor<JobPayload>
 	signal: AbortSignal
 }
 
-export class Worker<Job> {
+export class Worker<JobPayload> {
 	private concurrency: number
-	private registry: JobRegistry<Job>
+	private jobFields: (job: Job<JobPayload>) => Record<string, unknown>
-	private runner: JobExecutor<Job>
+	private logger: AppLogger
+	private registry: JobRegistry<JobPayload>
+	private runner: JobExecutor<JobPayload>
 	private signal: AbortSignal
 
-	constructor({ concurrency, registry, runner, signal }: WorkerConfig<Job>) {
+	constructor({
+		concurrency,
+		jobFields,
+		logger,
+		registry,
+		runner,
+		signal,
+	}: WorkerConfig<JobPayload>) {
 		this.concurrency = concurrency
+		this.jobFields = jobFields ?? emptyJobFields
+		this.logger = logger ?? rootLogger.child({ component: "worker" })
 		this.registry = registry
 		this.runner = runner
 		this.signal = signal
@@ -27,25 +42,45 @@ export class Worker<Job> {
 
 	start() {
 		if (this.signal.aborted) return
+		this.logger.debug({ concurrency: this.concurrency }, "worker started")
 		for (let i = 0; i < this.concurrency; i++) {
-			void this.pollJobFromRegistry()
+			void this.pollJobFromRegistry(i)
 		}
 	}
 
-	private async pollJobFromRegistry() {
+	private async pollJobFromRegistry(workerId: number) {
 		while (!this.signal.aborted) {
 			const job = await this.registry.nextJob(this.signal)
 			if (!job) {
 				return
 			}
 
+			const startedAt = Date.now()
+			const fields = {
+				...this.jobFields(job),
+				jobId: job.id,
+				workerId,
+			}
+			this.logger.debug(fields, "job execution started")
+
 			try {
 				await this.runner.execute(job)
-			} catch {
+				this.logger.debug(
-				// TODO: handle logging of job execution errors
+					{ ...fields, durationMs: Date.now() - startedAt },
+					"job execution completed",
+				)
+			} catch (err) {
+				this.logger.error(
+					{ ...fields, durationMs: Date.now() - startedAt, err },
+					"job execution failed",
+				)
 			} finally {
 				this.registry.markJobAsCompleted(job)
 			}
 		}
 	}
 }
+
+function emptyJobFields<JobPayload>(_job: Job<JobPayload>): Record<string, unknown> {
+	return {}
+}

apps/freya-backend/src/server.ts

@@ -21,6 +21,7 @@ import { createLlmClient } from "./enhancement/llm-client.ts"
 import { GoogleMapsSourceProvider } from "./google-maps/provider.ts"
 import { CredentialEncryptor } from "./lib/crypto.ts"
 import { ensureEnv } from "./lib/env.ts"
+import { logger } from "./lib/logger.ts"
 import { registerLocationHttpHandlers } from "./location/http.ts"
 import { LocationSourceProvider } from "./location/provider.ts"
 import { NotificationCentral } from "./notification/notification-central.ts"
@@ -77,7 +78,10 @@ function main() {
 		},
 	})
 	if (!piApiKey) {
-		console.warn("[query] PI_API_KEY or OPENROUTER_API_KEY not set — query agent unavailable")
+		logger.warn(
+			{ component: "query_agent" },
+			"PI_API_KEY or OPENROUTER_API_KEY not set; query agent unavailable",
+		)
 	}
 
 	const notificationCentral = new NotificationCentral()
@@ -87,6 +91,7 @@ function main() {
 		storage: conversationStorage,
 		userSessionManager: sessionManager,
 		signal: abortController.signal,
+		logger,
 	})
 
 	const app = new Hono()

bun.lock

@@ -76,6 +76,8 @@
         "drizzle-orm": "^0.45.1",
         "hono": "^4",
         "lodash.merge": "^4.6.2",
+        "pino": "^10.3.1",
+        "pino-pretty": "^13.1.3",
         "typebox": "^1.1.38",
       },
       "devDependencies": {
@@ -907,6 +909,8 @@
 
     "@oxlint/binding-win32-x64-msvc": ["@oxlint/binding-win32-x64-msvc@1.52.0", "", { "os": "win32", "cpu": "x64" }, "sha512-wikx9I9J9/lPOZlrCCNgm8YjWkia8NZfhWd1TTvZTMguyChbw/oA2VEM6Fzx+kkpA+1qu5Mo7nrLdOXEJavw8g=="],
 
+    "@pinojs/redact": ["@pinojs/redact@0.4.0", "", {}, "sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg=="],
+
     "@prisma/client": ["@prisma/client@7.4.2", "", { "dependencies": { "@prisma/client-runtime-utils": "7.4.2" }, "peerDependencies": { "prisma": "*", "typescript": ">=5.4.0" }, "optionalPeers": ["prisma", "typescript"] }, "sha512-ts2mu+cQHriAhSxngO3StcYubBGTWDtu/4juZhXCUKOwgh26l+s4KD3vT2kMUzFyrYnll9u/3qWrtzRv9CGWzA=="],
 
     "@prisma/client-runtime-utils": ["@prisma/client-runtime-utils@7.4.2", "", {}, "sha512-cID+rzOEb38VyMsx5LwJMEY4NGIrWCNpKu/0ImbeooQ2Px7TI+kOt7cm0NelxUzF2V41UVVXAmYjANZQtCu1/Q=="],
@@ -1677,6 +1681,8 @@
 
     "async-limiter": ["async-limiter@1.0.1", "", {}, "sha512-csOlWGAcRFJaI6m+F2WKdnMKr4HhdhFVBk0H/QbJFMCr+uO2kwohwXQPxw/9OCxp05r5ghVBFSyioixx3gfkNQ=="],
 
+    "atomic-sleep": ["atomic-sleep@1.0.0", "", {}, "sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ=="],
+
     "available-typed-arrays": ["available-typed-arrays@1.0.7", "", { "dependencies": { "possible-typed-array-names": "^1.0.0" } }, "sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ=="],
 
     "aws-ssl-profiles": ["aws-ssl-profiles@1.1.2", "", {}, "sha512-NZKeq9AfyQvEeNlN0zSYAaWrmBffJh3IELMZfRpJVWgrpEbtEpnjvzqBPf+mxoI287JohRDoa+/nsfqqiZmF6g=="],
@@ -1819,6 +1825,8 @@
 
     "color-string": ["color-string@1.9.1", "", { "dependencies": { "color-name": "^1.0.0", "simple-swizzle": "^0.2.2" } }, "sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg=="],
 
+    "colorette": ["colorette@2.0.20", "", {}, "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w=="],
+
     "comma-separated-tokens": ["comma-separated-tokens@2.0.3", "", {}, "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg=="],
 
     "commander": ["commander@14.0.3", "", {}, "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw=="],
@@ -1879,6 +1887,8 @@
 
     "data-view-byte-offset": ["data-view-byte-offset@1.0.1", "", { "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", "is-data-view": "^1.0.1" } }, "sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ=="],
 
+    "dateformat": ["dateformat@4.6.3", "", {}, "sha512-2P0p0pFGzHS5EMnhdxQi7aJN+iMheud0UhG4dlE1DLAlvL8JHjJJTX/CSm4JXwV0Ka5nGk3zC5mcb5bUQUxxMA=="],
+
     "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
 
     "decimal.js": ["decimal.js@10.6.0", "", {}, "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg=="],
@@ -1969,6 +1979,8 @@
 
     "encodeurl": ["encodeurl@2.0.0", "", {}, "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg=="],
 
+    "end-of-stream": ["end-of-stream@1.4.5", "", { "dependencies": { "once": "^1.4.0" } }, "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg=="],
+
     "enhanced-resolve": ["enhanced-resolve@5.20.0", "", { "dependencies": { "graceful-fs": "^4.2.4", "tapable": "^2.3.0" } }, "sha512-/ce7+jQ1PQ6rVXwe+jKEg5hW5ciicHwIQUagZkp6IufBoY3YDgdTTY1azVs0qoRgVmvsNB+rbjLJxDAeHHtwsQ=="],
 
     "entities": ["entities@4.5.0", "", {}, "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw=="],
@@ -2123,6 +2135,8 @@
 
     "fast-check": ["fast-check@3.23.2", "", { "dependencies": { "pure-rand": "^6.1.0" } }, "sha512-h5+1OzzfCC3Ef7VbtKdcv7zsstUQwUDlYpUTvjeUsJAssPgLn7QzbboPtL5ro04Mq0rPOsMzl7q5hIbRs2wD1A=="],
 
+    "fast-copy": ["fast-copy@4.0.3", "", {}, "sha512-58apWr0GUiDFM8+3afrO6eYwJBn9ZAhDOzG3L+/9llab/haCARS2UIfffmOurYLwbgDRs8n0rfr6qAAPEAuAQw=="],
+
     "fast-deep-equal": ["fast-deep-equal@3.1.3", "", {}, "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="],
 
     "fast-glob": ["fast-glob@3.3.3", "", { "dependencies": { "@nodelib/fs.stat": "^2.0.2", "@nodelib/fs.walk": "^1.2.3", "glob-parent": "^5.1.2", "merge2": "^1.3.0", "micromatch": "^4.0.8" } }, "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg=="],
@@ -2131,6 +2145,8 @@
 
     "fast-levenshtein": ["fast-levenshtein@2.0.6", "", {}, "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw=="],
 
+    "fast-safe-stringify": ["fast-safe-stringify@2.1.1", "", {}, "sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA=="],
+
     "fast-sha256": ["fast-sha256@1.3.0", "", {}, "sha512-n11RGP/lrWEFI/bWdygLxhI+pVeo1ZYIVwvvPkW7azl/rOy+F3HYRZ2K5zeE9mmkhQppyv9sQFx0JM9UabnpPQ=="],
 
     "fast-uri": ["fast-uri@3.1.0", "", {}, "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA=="],
@@ -2293,6 +2309,8 @@
 
     "headers-polyfill": ["headers-polyfill@4.0.3", "", {}, "sha512-IScLbePpkvO846sIwOtOTDjutRMWdXdJmXdMvk6gCBHxFO8d+QKOQedyZSxFTTFYRSmlgSTDtXqqq4pcenBXLQ=="],
 
+    "help-me": ["help-me@5.0.0", "", {}, "sha512-7xgomUX6ADmcYzFik0HzAxh/73YlKR9bmFzf51CZwR+b6YtzU2m0u49hQCqV6SvlqIqsaxovfwdvbnsw3b/zpg=="],
+
     "hermes-compiler": ["hermes-compiler@250829098.0.10", "", {}, "sha512-TcRlZ0/TlyfJqquRFAWoyElVNnkdYRi/sEp4/Qy8/GYxjg8j2cS9D4MjuaQ+qimkmLN7AmO+44IznRf06mAr0w=="],
 
     "hermes-estree": ["hermes-estree@0.25.1", "", {}, "sha512-0wUoCcLp+5Ev5pDW2OriHC2MJCbwLwuRx+gAqMTOkGKJJiBCLjtrvy4PWUGn6MIVefecRpzoOZ/UV6iGdOr+Cw=="],
@@ -2467,6 +2485,8 @@
 
     "jose": ["jose@6.2.1", "", {}, "sha512-jUaKr1yrbfaImV7R2TN/b3IcZzsw38/chqMpo2XJ7i2F8AfM/lA4G1goC3JVEwg0H7UldTmSt3P68nt31W7/mw=="],
 
+    "joycon": ["joycon@3.1.1", "", {}, "sha512-34wB/Y7MW7bzjKRjUKTa46I2Z7eV62Rkhva+KkopW7Qvv/OSWBqvkSY7vusOPrNuZcUG3tApvdVgNB8POj3SPw=="],
+
     "js-tokens": ["js-tokens@4.0.0", "", {}, "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="],
 
     "js-yaml": ["js-yaml@4.1.1", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA=="],
@@ -2823,6 +2843,8 @@
 
     "ohash": ["ohash@2.0.11", "", {}, "sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ=="],
 
+    "on-exit-leak-free": ["on-exit-leak-free@2.1.2", "", {}, "sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA=="],
+
     "on-finished": ["on-finished@2.4.1", "", { "dependencies": { "ee-first": "1.1.1" } }, "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg=="],
 
     "on-headers": ["on-headers@1.1.0", "", {}, "sha512-737ZY3yNnXy37FHkQxPzt4UZ2UWPWiCZWLvFZ4fu5cueciegX0zGPnrlY6bwRg4FdQOe9YU8MkmJwGhoMybl8A=="],
@@ -2911,6 +2933,14 @@
 
     "pify": ["pify@2.3.0", "", {}, "sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog=="],
 
+    "pino": ["pino@10.3.1", "", { "dependencies": { "@pinojs/redact": "^0.4.0", "atomic-sleep": "^1.0.0", "on-exit-leak-free": "^2.1.0", "pino-abstract-transport": "^3.0.0", "pino-std-serializers": "^7.0.0", "process-warning": "^5.0.0", "quick-format-unescaped": "^4.0.3", "real-require": "^0.2.0", "safe-stable-stringify": "^2.3.1", "sonic-boom": "^4.0.1", "thread-stream": "^4.0.0" }, "bin": { "pino": "bin.js" } }, "sha512-r34yH/GlQpKZbU1BvFFqOjhISRo1MNx1tWYsYvmj6KIRHSPMT2+yHOEb1SG6NMvRoHRF0a07kCOox/9yakl1vg=="],
+
+    "pino-abstract-transport": ["pino-abstract-transport@3.0.0", "", { "dependencies": { "split2": "^4.0.0" } }, "sha512-wlfUczU+n7Hy/Ha5j9a/gZNy7We5+cXp8YL+X+PG8S0KXxw7n/JXA3c46Y0zQznIJ83URJiwy7Lh56WLokNuxg=="],
+
+    "pino-pretty": ["pino-pretty@13.1.3", "", { "dependencies": { "colorette": "^2.0.7", "dateformat": "^4.6.3", "fast-copy": "^4.0.0", "fast-safe-stringify": "^2.1.1", "help-me": "^5.0.0", "joycon": "^3.1.1", "minimist": "^1.2.6", "on-exit-leak-free": "^2.1.0", "pino-abstract-transport": "^3.0.0", "pump": "^3.0.0", "secure-json-parse": "^4.0.0", "sonic-boom": "^4.0.1", "strip-json-comments": "^5.0.2" }, "bin": { "pino-pretty": "bin.js" } }, "sha512-ttXRkkOz6WWC95KeY9+xxWL6AtImwbyMHrL1mSwqwW9u+vLp/WIElvHvCSDg0xO/Dzrggz1zv3rN5ovTRVowKg=="],
+
+    "pino-std-serializers": ["pino-std-serializers@7.1.0", "", {}, "sha512-BndPH67/JxGExRgiX1dX0w1FvZck5Wa4aal9198SrRhZjH3GxKQUKIBnYJTdj2HDN3UQAS06HlfcSbQj2OHmaw=="],
+
     "pirates": ["pirates@4.0.7", "", {}, "sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA=="],
 
     "pkce-challenge": ["pkce-challenge@5.0.1", "", {}, "sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ=="],
@@ -2963,6 +2993,8 @@
 
     "proc-log": ["proc-log@4.2.0", "", {}, "sha512-g8+OnU/L2v+wyiVK+D5fA34J7EH8jZ8DDlvwhRCMxmMj7UCBvxiO1mGeN+36JXIKF4zevU4kRBd8lVgG9vLelA=="],
 
+    "process-warning": ["process-warning@5.0.0", "", {}, "sha512-a39t9ApHNx2L4+HBnQKqxxHNs1r7KF+Intd8Q/g1bUh6q0WIp9voPXJ/x0j+ZL45KF1pJd9+q2jLIRMfvEshkA=="],
+
     "progress": ["progress@2.0.3", "", {}, "sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA=="],
 
     "promise": ["promise@8.3.0", "", { "dependencies": { "asap": "~2.0.6" } }, "sha512-rZPNPKTOYVNEEKFaq1HqTgOwZD+4/YHS5ukLzQCypkj+OkYx7iv0mA91lJlpPPZ8vMau3IIGj5Qlwrx+8iiSmg=="],
@@ -2979,6 +3011,8 @@
 
     "proxy-addr": ["proxy-addr@2.0.7", "", { "dependencies": { "forwarded": "0.2.0", "ipaddr.js": "1.9.1" } }, "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg=="],
 
+    "pump": ["pump@3.0.4", "", { "dependencies": { "end-of-stream": "^1.1.0", "once": "^1.3.1" } }, "sha512-VS7sjc6KR7e1ukRFhQSY5LM2uBWAUPiOPa/A3mkKmiMwSmRFUITt0xuj+/lesgnCv+dPIEYlkzrcyXgquIHMcA=="],
+
     "punycode": ["punycode@2.3.1", "", {}, "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg=="],
 
     "pure-rand": ["pure-rand@6.1.0", "", {}, "sha512-bVWawvoZoBYpp6yIoQtQXHZjmz35RSVHnUOTefl8Vcjr8snTPY1wnpSPMWekcFwbxI6gtmT7rSYPFvz71ldiOA=="],
@@ -2991,6 +3025,8 @@
 
     "queue-microtask": ["queue-microtask@1.2.3", "", {}, "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A=="],
 
+    "quick-format-unescaped": ["quick-format-unescaped@4.0.4", "", {}, "sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg=="],
+
     "radix-ui": ["radix-ui@1.4.3", "", { "dependencies": { "@radix-ui/primitive": "1.1.3", "@radix-ui/react-accessible-icon": "1.1.7", "@radix-ui/react-accordion": "1.2.12", "@radix-ui/react-alert-dialog": "1.1.15", "@radix-ui/react-arrow": "1.1.7", "@radix-ui/react-aspect-ratio": "1.1.7", "@radix-ui/react-avatar": "1.1.10", "@radix-ui/react-checkbox": "1.3.3", "@radix-ui/react-collapsible": "1.1.12", "@radix-ui/react-collection": "1.1.7", "@radix-ui/react-compose-refs": "1.1.2", "@radix-ui/react-context": "1.1.2", "@radix-ui/react-context-menu": "2.2.16", "@radix-ui/react-dialog": "1.1.15", "@radix-ui/react-direction": "1.1.1", "@radix-ui/react-dismissable-layer": "1.1.11", "@radix-ui/react-dropdown-menu": "2.1.16", "@radix-ui/react-focus-guards": "1.1.3", "@radix-ui/react-focus-scope": "1.1.7", "@radix-ui/react-form": "0.1.8", "@radix-ui/react-hover-card": "1.1.15", "@radix-ui/react-label": "2.1.7", "@radix-ui/react-menu": "2.1.16", "@radix-ui/react-menubar": "1.1.16", "@radix-ui/react-navigation-menu": "1.2.14", "@radix-ui/react-one-time-password-field": "0.1.8", "@radix-ui/react-password-toggle-field": "0.1.3", "@radix-ui/react-popover": "1.1.15", "@radix-ui/react-popper": "1.2.8", "@radix-ui/react-portal": "1.1.9", "@radix-ui/react-presence": "1.1.5", "@radix-ui/react-primitive": "2.1.3", "@radix-ui/react-progress": "1.1.7", "@radix-ui/react-radio-group": "1.3.8", "@radix-ui/react-roving-focus": "1.1.11", "@radix-ui/react-scroll-area": "1.2.10", "@radix-ui/react-select": "2.2.6", "@radix-ui/react-separator": "1.1.7", "@radix-ui/react-slider": "1.3.6", "@radix-ui/react-slot": "1.2.3", "@radix-ui/react-switch": "1.2.6", "@radix-ui/react-tabs": "1.1.13", "@radix-ui/react-toast": "1.2.15", "@radix-ui/react-toggle": "1.1.10", "@radix-ui/react-toggle-group": "1.1.11", "@radix-ui/react-toolbar": "1.1.11", "@radix-ui/react-tooltip": "1.2.8", "@radix-ui/react-use-callback-ref": "1.1.1", "@radix-ui/react-use-controllable-state": "1.2.2", "@radix-ui/react-use-effect-event": "0.0.2", "@radix-ui/react-use-escape-keydown": "1.1.1", "@radix-ui/react-use-is-hydrated": "0.1.0", "@radix-ui/react-use-layout-effect": "1.1.1", "@radix-ui/react-use-size": "1.1.1", "@radix-ui/react-visually-hidden": "1.2.3" }, "peerDependencies": { "@types/react": "*", "@types/react-dom": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc", "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react", "@types/react-dom"] }, "sha512-aWizCQiyeAenIdUbqEpXgRA1ya65P13NKn/W8rWkcN0OPkRDxdBVLWnIEDsS2RpwCK2nobI7oMUSmexzTDyAmA=="],
 
     "range-parser": ["range-parser@1.2.1", "", {}, "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg=="],
@@ -3051,6 +3087,8 @@
 
     "readdirp": ["readdirp@4.1.2", "", {}, "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg=="],
 
+    "real-require": ["real-require@0.2.0", "", {}, "sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg=="],
+
     "recast": ["recast@0.23.11", "", { "dependencies": { "ast-types": "^0.16.1", "esprima": "~4.0.0", "source-map": "~0.6.1", "tiny-invariant": "^1.3.3", "tslib": "^2.0.1" } }, "sha512-YTUo+Flmw4ZXiWfQKGcwwc11KnoRAYgzAE2E7mXKCjSviTKShtxBsN6YUUBB2gtaBzKzeKunxhUwNHQuRryhWA=="],
 
     "redent": ["redent@3.0.0", "", { "dependencies": { "indent-string": "^4.0.0", "strip-indent": "^3.0.0" } }, "sha512-6tDA8g98We0zd0GvVeMT9arEOnTw9qM03L9cJXaCjrip1OO764RDBLBfrB4cwzNGDj5OA5ioymC9GkizgWJDUg=="],
@@ -3131,12 +3169,16 @@
 
     "safe-regex-test": ["safe-regex-test@1.1.0", "", { "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", "is-regex": "^1.2.1" } }, "sha512-x/+Cz4YrimQxQccJf5mKEbIa1NzeCRNI5Ecl/ekmlYaampdNLPalVyIcCZNNH3MvmqBugV5TMYZXv0ljslUlaw=="],
 
+    "safe-stable-stringify": ["safe-stable-stringify@2.5.0", "", {}, "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA=="],
+
     "safer-buffer": ["safer-buffer@2.1.2", "", {}, "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="],
 
     "sax": ["sax@1.5.0", "", {}, "sha512-21IYA3Q5cQf089Z6tgaUTr7lDAyzoTPx5HRtbhsME8Udispad8dC/+sziTNugOEx54ilvatQ9YCzl4KQLPcRHA=="],
 
     "scheduler": ["scheduler@0.27.0", "", {}, "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q=="],
 
+    "secure-json-parse": ["secure-json-parse@4.1.0", "", {}, "sha512-l4KnYfEyqYJxDwlNVyRfO2E4NTHfMKAWdUuA8J0yve2Dz/E/PdBepY03RvyJpssIpRFwJoCD55wA+mEDs6ByWA=="],
+
     "semver": ["semver@7.7.4", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA=="],
 
     "send": ["send@1.2.1", "", { "dependencies": { "debug": "^4.4.3", "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "etag": "^1.8.1", "fresh": "^2.0.0", "http-errors": "^2.0.1", "mime-types": "^3.0.2", "ms": "^2.1.3", "on-finished": "^2.4.1", "range-parser": "^1.2.1", "statuses": "^2.0.2" } }, "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ=="],
@@ -3195,6 +3237,8 @@
 
     "slugify": ["slugify@1.6.6", "", {}, "sha512-h+z7HKHYXj6wJU+AnS/+IH8Uh9fdcX1Lrhg1/VMdf9PwoBQXFcXiAdsy2tSK0P6gKwJLXp02r90ahUCqHk9rrw=="],
 
+    "sonic-boom": ["sonic-boom@4.2.1", "", { "dependencies": { "atomic-sleep": "^1.0.0" } }, "sha512-w6AxtubXa2wTXAUsZMMWERrsIRAdrK0Sc+FUytWvYAhBJLyuI4llrMIC1DtlNSdI99EI86KZum2MMq3EAZlF9Q=="],
+
     "sonner": ["sonner@2.0.7", "", { "peerDependencies": { "react": "^18.0.0 || ^19.0.0 || ^19.0.0-rc", "react-dom": "^18.0.0 || ^19.0.0 || ^19.0.0-rc" } }, "sha512-W6ZN4p58k8aDKA4XPcx2hpIQXBRAgyiWVkYhT7CvK6D3iAu7xjvVyhQHg2/iaKJZ1XVJ4r7XuwGL+WGEK37i9w=="],
 
     "source-map": ["source-map@0.6.1", "", {}, "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g=="],
@@ -3263,7 +3307,7 @@
 
     "strip-indent": ["strip-indent@3.0.0", "", { "dependencies": { "min-indent": "^1.0.0" } }, "sha512-laJTa3Jb+VQpaC6DseHhF7dXVqHTfJPCRDaEbid/drOhgitgYku/letMUqOXFoWV0zIIUbjpdH2t+tYj4bQMRQ=="],
 
-    "strip-json-comments": ["strip-json-comments@3.1.1", "", {}, "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig=="],
+    "strip-json-comments": ["strip-json-comments@5.0.3", "", {}, "sha512-1tB5mhVo7U+ETBKNf92xT4hrQa3pm0MZ0PQvuDnWgAAGHDsfp4lPSpiS6psrSiet87wyGPh9ft6wmhOMQ0hDiw=="],
 
     "strnum": ["strnum@2.4.0", "", { "dependencies": { "anynum": "^1.0.0" } }, "sha512-sHrVyWWdq28RbhjuJdZsA1SnGRJV6NiXbk6AXBxDOsgAcA+lmpUZCYjOdLBxkXMwis6RRe7dlZt4VlIWFVzkmg=="],
 
@@ -3301,6 +3345,8 @@
 
     "thenify-all": ["thenify-all@1.6.0", "", { "dependencies": { "thenify": ">= 3.1.0 < 4" } }, "sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA=="],
 
+    "thread-stream": ["thread-stream@4.2.0", "", { "dependencies": { "real-require": "^1.0.0" } }, "sha512-e2zZ96wSChazBsbENf/Pcm/4swHt2cEKQ92rhUjkL9GCKiTDJIaTBenjE/m9DXi0QBmTMDkFDdOomUy20A1tDQ=="],
+
     "throat": ["throat@5.0.0", "", {}, "sha512-fcwX4mndzpLQKBS1DVYhGAcYaYt7vsHNIvQV+WXMvnow5cgjPphq5CaayLaGsjRdSCKZFNGt7/GYAuXaNOiYCA=="],
 
     "tiny-invariant": ["tiny-invariant@1.3.3", "", {}, "sha512-+FbBPE1o9QAYvviau/qC5SE3caw21q3xkvWKBtja5vgqOWIHHJ3ioaq1VPfn/Szqctz2bU/oYeKd9/z5BL+PVg=="],
@@ -3633,6 +3679,8 @@
 
     "@eslint/eslintrc/minimatch": ["minimatch@3.1.5", "", { "dependencies": { "brace-expansion": "^1.1.7" } }, "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w=="],
 
+    "@eslint/eslintrc/strip-json-comments": ["strip-json-comments@3.1.1", "", {}, "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig=="],
+
     "@expo/cli/accepts": ["accepts@1.3.8", "", { "dependencies": { "mime-types": "~2.1.34", "negotiator": "0.6.3" } }, "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw=="],
 
     "@expo/cli/chalk": ["chalk@4.1.2", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA=="],
@@ -4015,6 +4063,8 @@
 
     "terser/commander": ["commander@2.20.3", "", {}, "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ=="],
 
+    "thread-stream/real-require": ["real-require@1.0.0", "", {}, "sha512-P4nbQYQfePJxRSmY+v/KINxVucm4NF3p3s7pJveMTtom52FR4YGltUQLB8idDXwDDWW+eYrWDFbuzUnjoWHF7g=="],
+
     "twrnc/tailwindcss": ["tailwindcss@3.4.19", "", { "dependencies": { "@alloc/quick-lru": "^5.2.0", "arg": "^5.0.2", "chokidar": "^3.6.0", "didyoumean": "^1.2.2", "dlv": "^1.1.3", "fast-glob": "^3.3.2", "glob-parent": "^6.0.2", "is-glob": "^4.0.3", "jiti": "^1.21.7", "lilconfig": "^3.1.3", "micromatch": "^4.0.8", "normalize-path": "^3.0.0", "object-hash": "^3.0.0", "picocolors": "^1.1.1", "postcss": "^8.4.47", "postcss-import": "^15.1.0", "postcss-js": "^4.0.1", "postcss-load-config": "^4.0.2 || ^5.0 || ^6.0", "postcss-nested": "^6.2.0", "postcss-selector-parser": "^6.1.2", "resolve": "^1.22.8", "sucrase": "^3.35.0" }, "bin": { "tailwind": "lib/cli.js", "tailwindcss": "lib/cli.js" } }, "sha512-3ofp+LL8E+pK/JuPLPggVAIaEuhvIz4qNcf3nA1Xn2o/7fb7s/TYpHhwGDv1ZU3PkBluUVaF8PyCHcm48cKLWQ=="],
 
     "vite/esbuild": ["esbuild@0.27.3", "", { "optionalDependencies": { "@esbuild/aix-ppc64": "0.27.3", "@esbuild/android-arm": "0.27.3", "@esbuild/android-arm64": "0.27.3", "@esbuild/android-x64": "0.27.3", "@esbuild/darwin-arm64": "0.27.3", "@esbuild/darwin-x64": "0.27.3", "@esbuild/freebsd-arm64": "0.27.3", "@esbuild/freebsd-x64": "0.27.3", "@esbuild/linux-arm": "0.27.3", "@esbuild/linux-arm64": "0.27.3", "@esbuild/linux-ia32": "0.27.3", "@esbuild/linux-loong64": "0.27.3", "@esbuild/linux-mips64el": "0.27.3", "@esbuild/linux-ppc64": "0.27.3", "@esbuild/linux-riscv64": "0.27.3", "@esbuild/linux-s390x": "0.27.3", "@esbuild/linux-x64": "0.27.3", "@esbuild/netbsd-arm64": "0.27.3", "@esbuild/netbsd-x64": "0.27.3", "@esbuild/openbsd-arm64": "0.27.3", "@esbuild/openbsd-x64": "0.27.3", "@esbuild/openharmony-arm64": "0.27.3", "@esbuild/sunos-x64": "0.27.3", "@esbuild/win32-arm64": "0.27.3", "@esbuild/win32-ia32": "0.27.3", "@esbuild/win32-x64": "0.27.3" }, "bin": { "esbuild": "bin/esbuild" } }, "sha512-8VwMnyGCONIs6cWue2IdpHxHnAjzxnw2Zr7MkVxB2vjmQ2ivqGFb4LEG3SMnv0Gb2F/G/2yA8zUaiL1gywDCCg=="],