This repo provides:

1. Async Python bridge runtime (source of truth).
2. Mock provider automation path for deterministic tests/dev.
3. Compliance-first manual_suno human-in-the-loop workflow.
4. JUCE plugin + standalone client with a shared manual-parity surface.

• mock_suno (default): bridge worker submits/polls/downloads automatically.
• manual_suno: bridge prepares handoff workspace and waits for explicit manual import.
• Beta runtime accepts only mock_suno and manual_suno.
• official_api, web_session remain future-scope placeholders and are rejected by the bridge in this milestone.

The JUCE plugin and standalone now both expose the same shared client surface with:

• provider selector (mock_suno / manual_suno)
• mode selector (Song, Sound, Audio Prompt)
• requested output families (mix, stems, tempo-locked stems, MIDI)
• sound fields (one-shot/loop, BPM, key)
• restart-safe reconnect that rehydrates lastActiveJobId from GET /jobs/{id}
• restore warnings surfaced in the shared status text after reconnect
• handoff actions (Prepare/Fetch, Reveal, Open instructions)
• manual result import (manual-complete endpoint) for only requested + pending families, then reveal/drag/copy

Preview is intentionally disabled for now across plugin + standalone until a full playback path is implemented.

No provider automation beyond mock_suno is introduced in this beta milestone.

• GET /capabilities
• POST /jobs/text
• POST /assets/import
• POST /jobs/audio
• GET /jobs/{job_id}
• POST /jobs/{job_id}/cancel
• GET /jobs/{job_id}/handoff
• POST /jobs/{job_id}/manual-complete

This repository does not implement scraping, browser automation, reverse engineering, session theft, or unofficial Suno APIs.

uv sync
uv run suno-bridge

JUCE (external):

cmake -S plugin_juce -B build/plugin_juce -Djuce_DIR=/path/to/JUCE/lib/cmake/JUCE
cmake --build build/plugin_juce --target bridge_client
cmake --build build/plugin_juce --target SunoStudioBridgeStandalone
cmake --build build/plugin_juce --target SunoStudioBridgePlugin
cmake --build build/plugin_juce --target BridgeContractVectors

uv run pytest -q
cmake --build build/plugin_juce --target BridgeContractVectors
./build/plugin_juce/BridgeContractVectors

If JUCE is unavailable, C++ binaries may not build in this environment.