Skip to content

docs(s2s): sweep stale hydra voice/default claims left after #384 - #385

Open
abhishekmishragithub wants to merge 2 commits into
mainfrom
fix/hydra-post-384-cleanup
Open

docs(s2s): sweep stale hydra voice/default claims left after #384#385
abhishekmishragithub wants to merge 2 commits into
mainfrom
fix/hydra-post-384-cleanup

Conversation

@abhishekmishragithub

Copy link
Copy Markdown
Collaborator

Summary

Small cleanup after PR #384. That PR corrected the Hydra model card + AsyncAPI, but four surrounding pages still carried the old claims. Sweeping them so the docs are internally consistent.

What was still stale

File Was Now
`speech-to-speech/overview.mdx` Note listed `wren`, `sloane`, `marlowe`, `reed`, `knox`, `tate` as the `?model=hydra` roster Note covers all three tags at a high level; points at the model card for rosters
`speech-to-speech/managing-sessions.mdx` `voice` field cited the six V1 voices + said "Unknown values silently fall back to the default" Points at the model card, states `sterling` as the default, corrects fallback claim to error frame with real code + param
`changelog-entries/general/2026-08-20-hydra-v1-1-release.mdx` Claimed original hydra voices `wren`... were unchanged (false) Pointer at the model card + notes hydra-v1.0 is also served and is the migration target the server names
`waves/pages/deprecation-notices.mdx` Listed `hydra-v1.1` as the only migration target Adds `hydra-v1.0` as an alternative (the tag the server's own warning frame names)

Live verification

Reprobed against `wss://api.smallest.ai/waves/v1/s2s` before writing:

  • Default voice (omit `voice` field) resolves to `sterling` on all three tags: `hydra-v1.1`, `hydra-v1.0`, `hydra`.
  • Unknown voice on `?model=hydra-v1.1`: `error` frame with `code: "invalid_request_error"`, `param: "session.configure.session.voice"`.

Test plan

  • `fern check` clean
  • Em-dash sweep on diff clean
  • No residual `wren` / `sloane` / `marlowe` / `knox` / `tate` names in the diff
  • Preview render: verify the Note on overview + the `voice` row on managing-sessions + the changelog + the deprecation table

Discrepancy to flag (not for this PR)

Reprobing surfaced a real gap in #384's roster claim worth a separate discussion. #384 documents `hydra-v1.1` as 10 voices and `hydra-v1.0` as 14 voices with the note that rosters do not overlap. On the wire:

Full accepted set on every tag: `alex, arden, aria, aspen, bellamy, blair, brooks, cole, elena, ellis, emery, grace, harlow, hayes, ivy, juno, kai, lane, lark, leo, linden, marin, maya, noor, pierce, quinn, rowan, sable, sam, sawyer, sterling, vaughn, wilder, zoe`. Ten of these (`aspen, bellamy, harlow, juno, lark, linden, marin, noor, sable, wilder`) do not appear in #384 at all.

This PR does not try to reopen that call. Model card and API ref stay as #384 shipped them. Worth pinging the PM / Aditya so they can decide whether the per-version split is a marketing/quality distinction the server doesn't enforce, or whether the docs should reflect the true 34-voice union.

#384 corrected the Hydra model card + AsyncAPI to reflect the wire
(hydra-v1.0 as first-class tag, real voice rosters, sterling default,
unknown-voice rejection). Four surrounding pages still cited the old
wren/sloane/marlowe/reed/knox/tate voices + the false silent-fallback
claim + missed hydra-v1.0 as a migration target. Aligning them:

- overview.mdx: Note callout now covers all three tags without
  hardcoded rosters; points at the model card for the per-version
  voice reference
- managing-sessions.mdx: voice field description points at the model
  card, states sterling default, and corrects the fallback claim to
  hard error frame with the exact code + param
- 2026-08-20-hydra-v1-1-release.mdx changelog: replaces the wren/etc
  claim with a pointer at the model card + notes hydra-v1.0 is also
  served and is the server's own named migration target
- deprecation-notices.mdx: adds hydra-v1.0 as the migration target the
  server's warning frame actually names

Live-verified end to end: default across all three tags = sterling,
unknown voice returns error(invalid_request_error) with
param=session.configure.session.voice.
sentinel was missing on the new page; ran scripts/inject_agent_callout.py
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