Skip to content

docs: mark round-2 stream/STT/realtime checklist done #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Bartok9 merged 1 commit into from
Jul 11, 2026
Merged

docs: mark round-2 stream/STT/realtime checklist done #8

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 11 additions & 4 deletions CURSOR-UPGRADE-ROUND-2.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,28 +7,35 @@ VISION/ARCHITECTURE, Grok TTS provider, radar, stability+SECURITY, sample phone

## Priority implementation PRs

### A — Stream Grok TTS (first audio latency)
### A — Stream Grok TTS (first audio latency) ✅ (PR #6)
1. Add streaming method on `GrokProvider` (WS or chunked if API documents)
2. Tests with mocked sockets
3. Route or canvas hook optional behind flag

### B — Grok STT provider
### B — Grok STT provider ✅ (PR #6)
1. `stt_providers/grok_provider.py` or analog matching existing STT base
2. Unit tests for missing key + happy path mock
3. Docs in docs/features/

### C — Experimental Realtime bridge (flagged)
### C — Experimental Realtime bridge (flagged) ✅ (PR #6, default off)
1. Server-side WS proxy to `wss://api.x.ai/v1/realtime?model=grok-voice-latest`
2. Never ship browser-facing raw XAI_API_KEY (ephemeral tokens if easy; else server only)
3. Minimal session.update (voice=eve, server_vad)
4. Feature flag default off
5. Smoke integration test with mocked WS

### D — Dev smoke
### D — Dev smoke ✅ (PR #6)
1. `scripts/smoke_grok_tts.py` → writes under /tmp, exits 0/1
2. README link "Grok works if you have XAI_API_KEY"

```bash
pytest -q tests/test_grok_tts_provider.py
# full suite needs requirements.txt
```


## Remaining after #6
- Canvas hook for stream TTFA optional
- Ephemeral token endpoint polish for browser clients
- Full pytest suite flask env in CI tissue
- Upstream PRs of Grok stack if MCERQUA wants them
1 change: 1 addition & 0 deletions docs/radar/2026-07-11.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ no live HTTP is required to produce this file._
- `ExternalSTTProvider`
- `grok`
- `GrokProvider`
- `GrokSTTProvider`
- `GrokTTSProvider`
- `groq`
- `GroqProvider`
Expand Down