// SPDX-FileCopyrightText: 2025 LiveKit, Inc. // // SPDX-License-Identifier: Apache-2.0 /** * Minimal example demonstrating idle user timeout functionality. * Direct port of: https://github.com/livekit/agents/blob/main/examples/voice_agents/inactive_user.py */ import { type JobContext, ServerOptions, Task, cli, defineAgent, delay, inference, initializeLogger, log, voice, } from '@livekit/agents'; import { fileURLToPath } from 'node:url'; initializeLogger({ pretty: true }); export default defineAgent({ entry: async (ctx: JobContext) => { const logger = log(); const session = new voice.AgentSession({ llm: new inference.LLM({ model: 'openai/gpt-4.1-mini' }), stt: new inference.STT({ model: 'deepgram/nova-3', language: 'en' }), tts: new inference.TTS({ model: 'cartesia/sonic-3', voice: '9626c31c-bec5-4cca-baa8-f8ba9e84c8bc', }), voiceOptions: { userAwayTimeout: 12.5, }, }); let task: Task | null = null; const userPresenceTask = async (controller: AbortController): Promise => { for (let i = 0; i < 3; i++) { if (controller.signal.aborted) return; const reply = await session.generateReply({ instructions: 'The user has been inactive. Politely check if the user is still present.', }); await reply.waitForPlayout(); try { await delay(10000, { signal: controller.signal }); } catch { return; } } if (!controller.signal.aborted) { await session.close(); } }; session.on(voice.AgentSessionEventTypes.UserStateChanged, (event) => { logger.info({ event }, 'User state changed'); if (task) { task.cancel(); } if (event.newState === 'away') { task = Task.from(userPresenceTask); return; } }); const agent = new voice.Agent({ instructions: 'You are a helpful assistant.', }); await session.start({ agent, room: ctx.room }); }, }); cli.runApp(new ServerOptions({ agent: fileURLToPath(import.meta.url) }));