Whissle · Build a voice agent app
What changed
Every edition of the guide, what moved in it, and whether it means you have to change anything. Older editions stay readable at their own URLs — a link you shared still says what it said then.
@whissle/agents 0.5.0@whissle/sdk 0.3.0@whissle/cli 1.0.2
Since v1 (12 August 2026).
- addedA section on what the page can hear — tool-started / tool-progress / tool-finished with args, result and citations, plus `thinking`, `agent-partial`, `agent-word` and `listening-started`.When an agent calls a tool it stops talking. Before 0.5.0 an embed went silent for however long the tool took, with no event to hang a UI on — and every caller reads silence as a hang.
- added`sendText()` — type into a live call, or take a turn over HTTP without one.A visitor who cannot speak, or will not in an open-plan office, had no way to use a voice agent at all.
- changedHistory now reads `sessions`, not `calls`.`calls` means “rows from the calls table” and structurally cannot see a text thread. Anyone building a text product was reading a fraction of their own history with no signal the rest existed.
- added`sessions.trace(id)` — which provider and model actually answered a turn, and whether it failed over mid-turn.It is the only view in the product of what really served a conversation, which is the first question when a call goes strange.
- changedErrors are typed and carry a code: 402 out of credit, 403 missing scope (named), 404 not found.The old guidance was one sentence — “check the key and the agent id” — for three unrelated failures with three different fixes.
- fixedThe microphone is checked before connecting, with the fix in the message.A refused microphone used to bring the session up and then ignore the visitor for the entire call.
- fixed`whissle` CLI links point at whissle.ai, not the retired platform.whissle.ai.That host answers 503, and the URL is persisted in ~/.whissle/config.json — so 1.0.2 migrates a stored one rather than only changing the default.
@whissle/agents 0.4.0@whissle/sdk 0.2.0@whissle/cli 1.0.1
- addedThe first public edition: provision agents from one JSON file, mint a session server-side, run a call with or without an avatar, read transcripts and scores.Everything before this was a private example nobody outside the team could run.