Update Node starter to LiveKit Agents 1.5#54
Merged
Conversation
Bump @livekit/agents to the 0.0.0-next-20260624041820 pre-release (next
dist-tag) to validate against the upcoming 1.5.0 release. Pinned exactly
for reproducible validation; to be repinned to stable 1.5.0 on release.
Update the commented-out tools example in agent.ts to the 1.5.0 flat-array
tool syntax with a required `name` (llm.tool({ name, ... }) in a `tools: [...]`
array), and note that voice.Agent.create({...}) is now available as an
alternative to subclassing voice.Agent.
Co-authored-by: Cursor <cursoragent@cursor.com>
check-template-files fails when pnpm-lock.yaml is tracked, and these files (absent on main) altered CI's install so prettier wasn't resolved. Untrack them to align with main. Co-authored-by: Cursor <cursoragent@cursor.com>
u9g
reviewed
Jun 24, 2026
| super({ | ||
| instructions: dedent` | ||
| // Build a custom voice AI assistant with the functional `Agent.create` API | ||
| // (introduced in @livekit/agents 1.5.0). You can also subclass `voice.Agent`. |
Contributor
There was a problem hiding this comment.
I don't think it's a good idea to say you can also subclass voice.Agent, since they should be equally powerful(?)
Collaborator
Author
There was a problem hiding this comment.
Both are equally powerful just differ in syntax
Contributor
There was a problem hiding this comment.
yeah so no need to have the second line of the comment
Collaborator
Author
There was a problem hiding this comment.
Removed the second comment line.
rektdeckard
reviewed
Jun 24, 2026
rektdeckard
left a comment
rektdeckard
left a comment
Contributor
There was a problem hiding this comment.
I think we should wait for stable release to update our public templates, but otherwise this looks good.
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
toubatbrian
changed the title
Co-authored-by: Cursor <cursoragent@cursor.com>
u9g
reviewed
Jul 10, 2026
| super({ | ||
| instructions: dedent` | ||
| // Build a custom voice AI assistant with the functional `Agent.create` API | ||
| // (introduced in @livekit/agents 1.5.0). You can also subclass `voice.Agent`. |
Contributor
There was a problem hiding this comment.
yeah so no need to have the second line of the comment
| }, | ||
| "dependencies": { | ||
| "@livekit/agents": "^1.4.7", | ||
| "@livekit/agents": "1.5.x", |
Collaborator
Author
There was a problem hiding this comment.
Changed the range to ^1.5.0. I also upgraded the starter to Zod 4.
Co-authored-by: Cursor <cursoragent@cursor.com>
u9g
approved these changes
Jul 10, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates the Node starter to the stable LiveKit Agents 1.5 release line and adapts the starter to the 1.5 API.
@livekit/agents1.5.x, currently resolving to 1.5.0.@livekit/rtc-node^0.13.31to satisfy the Agents 1.5 peer requirement.Agent.createAPI and current tool/toolset examples.mainchanges, including Node 24 native type stripping and the Gemma 31B default model.pnpm-lock.yamlandpnpm-workspace.yamluntracked, matching the existing starter template policy.Validation
pnpm typecheck— passed.pnpm lint— passed.pnpm test— passed (3 tests).pnpm peers check— passed; no peer dependency issues.pnpm build— not available because currentmainintentionally removed the build script in favor of running TypeScript directly with Node 24.Dependency installation resolved
@livekit/agents1.5.0 and@livekit/rtc-node0.13.31. Local verification ran with Node 22.15.1 and emitted the expected engine warning because the merged starter now requires Node 24.