stt-integration

# STT Integration Skill ## Mission Integrate STT providers that emit consistent interim/final transcripts, word interruption packets, and `stt_latency_ms` metrics. ## Inputs expected from user 1. Ingestion transport: WS, SDK callbacks, or HTTP chunks. 2. Interim transcript requirements. 3. Language/model constraints. If missing: - Use nearest transport baseline and preserve packet semantics. ## Hard boundaries In scope: - `api/assistant-api/internal/transformer/<provider>/stt.go` (+ helpers) - `api/assistant-api/internal/transformer/transformer.go` - optional contract updates: `api/assistant-api/internal/type/stt_transformer.go`, `packet.go` - provider STT metadata and UI components Out of scope: - TTS-only internals - telephony internals - EOS/VAD algorithms ## Packet contract Input: - `UserAudioPacket` Required outputs: - `SpeechToTextPacket` interim/final - `InterruptionPacket{Source:"word"}` when available - `ConversationEventPacket{Name:"stt", ...}` - `MessageMetricPacket{Name:"stt_latency_ms"}` once per utterance ## Implementation workflow 1. Pick baseline (`deepgram`, `assembly-ai`, `azure`, `google`, `aws`, `sarvam`). 2. Implement provider package under transformer. 3. Register in STT factory switch. 4. Wire UI provider model/language config. 5. Validate transcript ordering and context consistency. 6. Add provider + integration tests. ## Governed lifecycle - Classify work as Fast, Standard, or Governed using `DEVELOPMENT_PROCESS.md`; use the full gated lifecycle only for Governed work. - This skill operates only in its assigned phase and path ownership; it may not approve its own plan or code review. - Governed implementation starts only from a coordinator-attested approved plan; Fast and Standard work follows its lighter documented lifecycle. - Return changed-file and verification evidence to the coordinator, then route the complete verified diff to the read-only `code-reviewer`. ## Validation commands - `go test ./api/assistant-api/internal/transformer/... -run TestSTT` - `go test ./api/assistant-api/internal/transformer/<provider>/...` - `cd ui && yarn test providers` - `./skills/stt-integration/scripts/validate.sh --check-diff --provider <provider>` ## References - `references/checklist.md` - `references/stt-checklist.md` - `examples/sample.md`