AgenticSuno
Adaptive background music for coding agents in VS Code.
AgenticSuno now uses Google Lyria Realtime as the primary engine for low-latency continuous music steering, with Suno/mock fallback preserved for compatibility.
What Changed
- Primary engine:
Lyria Realtime streaming from extension host to webview.
- Fallback engine:
Suno URL playback (or mock mode) when Gemini key is missing/unavailable.
- Strict Lyria-first generation: when Lyria is available, Suno
generate/extend is blocked unless engine is explicitly set to suno.
- Engine abstraction introduced in
src/music/engine/.
- Host-side API key handling only (Gemini key is never posted to the webview).
- Webview now supports streaming protocol messages:
streamInitstreamChunkstreamPausestreamResumestreamStopstreamResetstreamError
Features
- Detects coding-agent activity (output channels, terminal, file edits).
- Mood + intensity classification (
epic, focused, tense, triumphant, ambient).
- Realtime mood steering without reconnect in normal operation.
- Sidebar player with play/pause/stop/skip and volume controls.
- Persisted project theme + track/preset library in workspace state.
Configuration
| Setting |
Default |
Description |
agenticSuno.engine |
"auto" |
Engine selection: auto, lyria, suno. |
agenticSuno.geminiApiKey |
"" |
Gemini API key for Lyria realtime. |
agenticSuno.lyriaModel |
"models/lyria-realtime-exp" |
Lyria model name. |
agenticSuno.lyriaStyleAnchor |
"cinematic electronic soul with expressive harmonic movement, textured low-end groove, evolving melodic motifs, polished modern production, dynamic transitions, emotionally rich atmosphere" |
Base style text applied to all generated Lyria prompts. |
agenticSuno.lyriaEvolutionStrength |
"strong" |
Steering strength for activity-driven evolution (subtle, balanced, strong). |
agenticSuno.lyriaSkipVariation |
0.85 |
Variation amount for skip-triggered fresh sections (0.0 to 1.0). |
agenticSuno.apiKey |
"" |
Suno API key (fallback path). |
agenticSuno.useMock |
false |
Mock fallback data for Suno path. |
agenticSuno.autoPlayOnActivity |
true |
Auto-start on activity. |
Example overrides in .vscode/settings.json:
{
"agenticSuno.lyriaStyleAnchor": "cinematic electro-pop pulse, expressive hooks, warm bass motion, polished transitions",
"agenticSuno.lyriaEvolutionStrength": "balanced",
"agenticSuno.lyriaSkipVariation": 0.9
}
Security Model
- Gemini and Suno keys stay in extension host process.
- Keys are never sent to the webview.
- Stream payloads contain audio chunks and metadata only.
Architecture Summary
MusicManager: engine selection, activity steering, command orchestration.LyriaClient: websocket lifecycle, setup handshake, chunk parsing, reconnect/backoff.LyriaEngineAdapter: high-level session control (PLAY, PAUSE, STOP, RESET_CONTEXT).SunoEngineAdapter: Suno fallback behind a shared generation interface.PlayerViewProvider + media/player.js: host-webview protocol and streaming playback engine.
Development
npm install
npm run compile
npm test
Open the repository in VS Code and press F5 to run the extension host.
| |
