Skip to content

feat(voice): support onUserTurnExceeded as an Agent.create hook#1827

Open
toubatbrian wants to merge 2 commits into
1.5.0from
brian/user-turn-exceeded-hook
Open

feat(voice): support onUserTurnExceeded as an Agent.create hook#1827
toubatbrian wants to merge 2 commits into
1.5.0from
brian/user-turn-exceeded-hook

Conversation

@toubatbrian

@toubatbrian toubatbrian commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Wire onUserTurnExceeded through AgentHooks so it can be supplied to Agent.create() and AgentTask.create(), not just via subclass override (mirrors the onUserTurnCompleted wiring).
  • Gate the callback on schedulingPaused / newTurnsBlocked — a start guard plus a post-wait re-check — to match the Python reference, so it is skipped during agent handoffs.
  • Rewrite the handoff tests to assert the gated behavior (skip-when-blocked, skip-when-paused, in-flight abort mid-wait, plus a positive control), replacing a stale test that incorrectly claimed Python never gates on newTurnsBlocked.

Test plan

  • pnpm build:agents
  • pnpm test -- agents/src/voice/agent.test.ts agents/src/voice/agent_activity.test.ts agents/src/voice/agent_activity_handoff.test.ts agents/src/voice/audio_recognition_handoff.test.ts (79 passing)
  • ESLint + Prettier on changed files

Notes

  • onUserTurnExceeded now works via both Agent.create({ onUserTurnExceeded }) and subclass override; docs can drop the "subclass-only" note once this lands.
  • Pre-existing pnpm api:check failure on export * as beta is unrelated to this change.

toubatbrian and others added 2 commits June 18, 2026 14:16
Wire onUserTurnExceeded through AgentHooks so it can be provided to
Agent.create()/AgentTask.create() in addition to subclass overrides,
mirroring the onUserTurnCompleted wiring. Also gate the callback on
schedulingPaused/newTurnsBlocked (start guard + post-wait re-check) to
match the Python reference, and update the handoff tests accordingly.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@changeset-bot

changeset-bot Bot commented Jun 18, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fbff6cf

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 35 packages
Name Type
@livekit/agents Patch
@livekit/agents-plugin-anam Patch
@livekit/agents-plugin-assemblyai Patch
@livekit/agents-plugin-baseten Patch
@livekit/agents-plugin-bey Patch
@livekit/agents-plugin-cartesia Patch
@livekit/agents-plugin-cerebras Patch
@livekit/agents-plugin-deepgram Patch
@livekit/agents-plugin-did Patch
@livekit/agents-plugin-elevenlabs Patch
@livekit/agents-plugin-fishaudio Patch
@livekit/agents-plugin-google Patch
@livekit/agents-plugin-hedra Patch
@livekit/agents-plugin-hume Patch
@livekit/agents-plugin-inworld Patch
@livekit/agents-plugin-lemonslice Patch
@livekit/agents-plugin-liveavatar Patch
@livekit/agents-plugin-livekit Patch
@livekit/agents-plugin-minimax Patch
@livekit/agents-plugin-mistral Patch
@livekit/agents-plugin-mistralai Patch
@livekit/agents-plugin-neuphonic Patch
@livekit/agents-plugin-openai Patch
@livekit/agents-plugin-perplexity Patch
@livekit/agents-plugin-phonic Patch
@livekit/agents-plugin-resemble Patch
@livekit/agents-plugin-rime Patch
@livekit/agents-plugin-runway Patch
@livekit/agents-plugin-sarvam Patch
@livekit/agents-plugin-silero Patch
@livekit/agents-plugin-soniox Patch
@livekit/agents-plugin-tavus Patch
@livekit/agents-plugins-test Patch
@livekit/agents-plugin-trugen Patch
@livekit/agents-plugin-xai Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Open in Devin Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant