1. 1//! Provider-neutral voice contracts and deterministic audio primitives
2. 2//! (docs/design/49-live-voice.md). Surfaces never own audio transport,
3. 3//! credentials, or conversational policy; this crate owns the vocabulary
4. 4//! they share: which providers exist, the socket wire protocol, the speech
5. 5//! evidence an utterance must carry before it may cost a provider call, and
6. 6//! the offline engines.
7. 7
8. 8use serde::{Deserialize, Serialize};
9. 9use thiserror::Error;
10. 10
11. 11pub mod audio;
12. 12pub mod local;
13. 13pub mod protocol;
14. 14pub mod provider;
15. 15pub mod vad;
16. 16
17. 17pub use local::{
18. 18 EngineReadiness, LocalTranscriber, LocalTtsSpeaker, TRANSCRIBER_VAR, TTS_VAR, engine_readiness,
19. 19};
20. 20pub use provider::{VoiceDescriptor, VoiceProvider, catalogue};
21. 21
22. 22#[derive(Debug, Error)]
23. 23pub enum VoiceError {
24. 24 #[error("voice provider unavailable: {0}")]
25. 25 Unavailable(String),
26. 26 #[error("voice request rejected: {0}")]
27. 27 InvalidRequest(String),
28. 28 #[error("voice operation cancelled")]
29. 29 Cancelled,
30. 30 #[error("voice transport failed: {0}")]
31. 31 Transport(String),
32. 32}
33. 33
34. 34#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
35. 35#[serde(rename_all = "snake_case")]
36. 36pub enum SpeakFormat {
37. 37 Pcm16,
38. 38 OggOpus,
39. 39 Mp3,
40. 40 Wav,
41. 41}
42. 42
43. 43impl SpeakFormat {
44. 44 pub fn parse(value: &str) -> Option<Self> {
45. 45 match value {
46. 46 "wav" => Some(Self::Wav),
47. 47 "pcm16" => Some(Self::Pcm16),
48. 48 "ogg_opus" => Some(Self::OggOpus),
49. 49 "mp3" => Some(Self::Mp3),
50. 50 _ => None,
51. 51 }
52. 52 }
53. 53
54. 54 /// The canonical name, as accepted by [`Self::parse`] and passed to a
55. 55 /// local engine.
56. 56 pub fn as_arg(self) -> &'static str {
57. 57 match self {
58. 58 Self::Pcm16 => "pcm16",
59. 59 Self::OggOpus => "ogg_opus",
60. 60 Self::Mp3 => "mp3",
61. 61 Self::Wav => "wav",
62. 62 }
63. 63 }
64. 64
65. 65 pub fn mime(self) -> &'static str {
66. 66 match self {
67. 67 Self::Pcm16 => "audio/pcm",
68. 68 Self::OggOpus => "audio/ogg",
69. 69 Self::Mp3 => "audio/mpeg",
70. 70 Self::Wav => "audio/wav",
71. 71 }
72. 72 }
73. 73}
74. 74