Run the SongPilot orchestrator to interact with AI agents.

This is the primary interface for interacting with SongPilot's AI system. The orchestrator routes your requests to appropriate specialists (visual-director, manager, publicist, etc.) based on your needs.

Args: message: Your request or question for the SongPilot AI. Examples: - "Create artwork for my song 'Midnight Dreams'" - "Help me plan a release strategy for my new album" - "Write a bio for my artist profile" - "Which of my songs are ready for release?"

session_id: Optional session identifier for conversation continuity.
           If omitted, the server maintains session continuity automatically.
           Use this if you want to explicitly reference a previous conversation.

context: Optional context about your current activity.
        Providing context helps the AI give more relevant responses:
        {
            "currentPage": "/songs",
            "activeTab": "albums",
            "focusedResource": {"type": "album", "name": "My Album"}
        }

ctx: FastMCP context (auto-injected, used for logging).

Returns: The AI's response as text. This may include suggestions, questions, generated content, or action items depending on your request.

Examples: >>> result = await run_orchestrator("Create artwork for my song 'Midnight Dreams'") >>> print(result) "I'd be happy to help create artwork for 'Midnight Dreams'! What style are you envisioning? Minimal, artistic, or something else?"

>>> # Continue conversation with context
>>> result = await run_orchestrator(
...     "Make it minimal with blue tones",
...     context={"currentPage": "/songs", "activeTab": "singles"}
... )

Raises: SongPilotError: If the API call fails (network error, auth error, etc.)

Note: - Session continuity is maintained automatically within a Claude conversation - The orchestrator remembers context from previous messages - API calls may take 10-30 seconds for complex generation tasks