livepilot 1.0.0

package/remote_script/LivePilot/transport.py

@@ -0,0 +1,151 @@
+"""
+LivePilot - Transport domain handlers (10 commands).
+"""
+
+from .router import register
+
+
+@register("get_session_info")
+def get_session_info(song, params):
+    """Return comprehensive session state."""
+    tracks_info = []
+    for i, track in enumerate(song.tracks):
+        tracks_info.append({
+            "index": i,
+            "name": track.name,
+            "color_index": track.color_index,
+            "has_midi_input": track.has_midi_input,
+            "has_audio_input": track.has_audio_input,
+            "mute": track.mute,
+            "solo": track.solo,
+            "arm": track.arm,
+        })
+
+    return_tracks_info = []
+    for i, track in enumerate(song.return_tracks):
+        return_tracks_info.append({
+            "index": i,
+            "name": track.name,
+            "color_index": track.color_index,
+            "mute": track.mute,
+            "solo": track.solo,
+        })
+
+    scenes_info = []
+    for i, scene in enumerate(song.scenes):
+        scenes_info.append({
+            "index": i,
+            "name": scene.name,
+            "color_index": scene.color_index,
+            "tempo": scene.tempo if scene.tempo > 0 else None,
+        })
+
+    return {
+        "tempo": song.tempo,
+        "signature_numerator": song.signature_numerator,
+        "signature_denominator": song.signature_denominator,
+        "is_playing": song.is_playing,
+        "song_length": song.song_length,
+        "current_song_time": song.current_song_time,
+        "loop": song.loop,
+        "loop_start": song.loop_start,
+        "loop_length": song.loop_length,
+        "metronome": song.metronome,
+        "record_mode": song.record_mode,
+        "session_record": song.session_record,
+        "track_count": len(list(song.tracks)),
+        "return_track_count": len(list(song.return_tracks)),
+        "scene_count": len(list(song.scenes)),
+        "tracks": tracks_info,
+        "return_tracks": return_tracks_info,
+        "scenes": scenes_info,
+    }
+
+
+@register("set_tempo")
+def set_tempo(song, params):
+    """Set the song tempo in BPM."""
+    tempo = float(params["tempo"])
+    if tempo < 20 or tempo > 999:
+        raise ValueError("Tempo must be between 20 and 999 BPM")
+    song.tempo = tempo
+    return {"tempo": song.tempo}
+
+
+@register("set_time_signature")
+def set_time_signature(song, params):
+    """Set the song time signature."""
+    numerator = int(params["numerator"])
+    denominator = int(params["denominator"])
+    if numerator < 1 or numerator > 99:
+        raise ValueError("Numerator must be between 1 and 99")
+    if denominator not in (1, 2, 4, 8, 16):
+        raise ValueError("Denominator must be 1, 2, 4, 8, or 16")
+    song.signature_numerator = numerator
+    song.signature_denominator = denominator
+    return {
+        "signature_numerator": song.signature_numerator,
+        "signature_denominator": song.signature_denominator,
+    }
+
+
+@register("start_playback")
+def start_playback(song, params):
+    """Start playback from the beginning."""
+    song.start_playing()
+    return {"is_playing": True}
+
+
+@register("stop_playback")
+def stop_playback(song, params):
+    """Stop playback."""
+    song.stop_playing()
+    return {"is_playing": False}
+
+
+@register("continue_playback")
+def continue_playback(song, params):
+    """Continue playback from the current position."""
+    song.continue_playing()
+    return {"is_playing": True}
+
+
+@register("toggle_metronome")
+def toggle_metronome(song, params):
+    """Enable or disable the metronome."""
+    enabled = bool(params["enabled"])
+    song.metronome = enabled
+    return {"metronome": song.metronome}
+
+
+@register("set_session_loop")
+def set_session_loop(song, params):
+    """Enable/disable loop and optionally set loop start/length."""
+    # Set region FIRST — setting loop_start/loop_length can reset song.loop
+    if "loop_start" in params:
+        song.loop_start = float(params["loop_start"])
+    if "loop_length" in params:
+        song.loop_length = float(params["loop_length"])
+    # Set enabled LAST so it sticks
+    enabled = bool(params["enabled"])
+    song.loop = enabled
+    # Echo requested value — song.loop getter may return stale state
+    return {
+        "loop": enabled,
+        "loop_start": song.loop_start,
+        "loop_length": song.loop_length,
+    }
+
+
+@register("undo")
+def undo(song, params):
+    """Undo the last action."""
+    song.undo()
+    return {"undone": True}
+
+
+@register("redo")
+def redo(song, params):
+    """Redo the last undone action."""
+    song.redo()
+    return {"redone": True}

package/remote_script/LivePilot/utils.py

@@ -0,0 +1,123 @@
+"""
+LivePilot - Error formatting, validation helpers, and JSON serialization.
+"""
+
+import json
+
+
+# ── Error codes ──────────────────────────────────────────────────────────────
+
+INDEX_ERROR = "INDEX_ERROR"
+NOT_FOUND = "NOT_FOUND"
+INVALID_PARAM = "INVALID_PARAM"
+STATE_ERROR = "STATE_ERROR"
+TIMEOUT = "TIMEOUT"
+INTERNAL = "INTERNAL"
+
+
+# ── Response builders ────────────────────────────────────────────────────────
+
+def success_response(request_id, result=None):
+    """Build a success JSON-RPC-style response."""
+    resp = {"id": request_id, "ok": True}
+    if result is not None:
+        resp["result"] = result
+    return resp
+
+
+def error_response(request_id, message, code=INTERNAL):
+    """Build an error JSON-RPC-style response."""
+    return {
+        "id": request_id,
+        "ok": False,
+        "error": {
+            "code": code,
+            "message": str(message),
+        },
+    }
+
+
+# ── Validation helpers ───────────────────────────────────────────────────────
+
+MASTER_TRACK_INDEX = -1000
+
+
+def get_track(song, track_index):
+    """Return a track by index (0-based).  Supports negative indices for
+    return tracks: -1 = first return, -2 = second return, etc.
+    Use -1000 for the master track."""
+    if track_index == MASTER_TRACK_INDEX:
+        return song.master_track
+    tracks = list(song.tracks)
+    if track_index < 0:
+        return_tracks = list(song.return_tracks)
+        ri = abs(track_index) - 1
+        if ri >= len(return_tracks):
+            raise IndexError(
+                "Return track index %d out of range (0..%d)"
+                % (ri, len(return_tracks) - 1)
+            )
+        return return_tracks[ri]
+    if track_index >= len(tracks):
+        raise IndexError(
+            "Track index %d out of range (0..%d)"
+            % (track_index, len(tracks) - 1)
+        )
+    return tracks[track_index]
+
+
+def get_clip_slot(song, track_index, clip_index):
+    """Return a clip slot by track + slot index."""
+    track = get_track(song, track_index)
+    slots = list(track.clip_slots)
+    if clip_index < 0 or clip_index >= len(slots):
+        raise IndexError(
+            "Clip slot index %d out of range (0..%d)"
+            % (clip_index, len(slots) - 1)
+        )
+    return slots[clip_index]
+
+
+def get_clip(song, track_index, clip_index):
+    """Return a clip (must exist in the slot)."""
+    slot = get_clip_slot(song, track_index, clip_index)
+    clip = slot.clip
+    if clip is None:
+        raise ValueError(
+            "No clip in track %d, slot %d" % (track_index, clip_index)
+        )
+    return clip
+
+
+def get_device(track, device_index):
+    """Return a device from a track by index."""
+    devices = list(track.devices)
+    if not devices:
+        raise IndexError(
+            "Track '%s' has no devices — load an instrument or effect first"
+            % track.name
+        )
+    if device_index < 0 or device_index >= len(devices):
+        raise IndexError(
+            "Device index %d out of range (0..%d) on track '%s'"
+            % (device_index, len(devices) - 1, track.name)
+        )
+    return devices[device_index]
+
+
+def get_scene(song, scene_index):
+    """Return a scene by index."""
+    scenes = list(song.scenes)
+    if scene_index < 0 or scene_index >= len(scenes):
+        raise IndexError(
+            "Scene index %d out of range (0..%d)"
+            % (scene_index, len(scenes) - 1)
+        )
+    return scenes[scene_index]
+
+
+# ── JSON serialization ───────────────────────────────────────────────────────
+
+def serialize_json(data):
+    """Serialize *data* to a compact JSON string with a trailing newline."""
+    return json.dumps(data, separators=(",", ":"), ensure_ascii=True) + "\n"

package/requirements.txt

@@ -0,0 +1,2 @@
+# LivePilot MCP Server dependencies
+fastmcp>=3.0.0,<4.0.0