feat(realtime): add resolution option

[AdirAmsalem]

Summary

Lets users of realtime models opt into 1080p output via a new resolution option on realtime.connect. Defaults to 720p (no behavior change for existing callers).

Usage

const realtimeClient = await client.realtime.connect(stream, {
  model: models.realtime("lucy-2.1"),
  resolution: "1080p", // default: "720p"
  onRemoteStream,
});

Test plan

• pnpm typecheck
• pnpm test (4 new unit tests covering URL construction + Zod validation)
• pnpm format:check
• Manual smoke against staging: verify lucy-2.1 + resolution: "1080p" delivers a 1884×1080 remote track

---

Note

Low Risk
Low risk: adds an optional, Zod-validated resolution parameter that only affects realtime WebRTC URL query construction, with coverage to prevent invalid values.

Overview
Adds a new optional resolution setting to realtime.connect (validated as "720p" or "1080p") and forwards it to the realtime WebRTC endpoint via a resolution= query parameter when provided.

Updates the SDK README with usage examples and adds unit tests verifying URL construction (param omitted vs appended) and input validation for invalid resolutions.

^{Reviewed by Cursor Bugbot for commit 56c8621. Bugbot is set up for automated code reviews on this repo. Configure here.}

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@decartai/sdk@140

commit: 56c8621