Merge pull request #65 from salignatmoandal/feat/inspect-source-loaded

inspect: report `sources[].loaded` for agents

crates/engine/src/inspect.rs

@@ -80,7 +80,10 @@ pub fn session(e: &Engine, full: bool) -> Value {
         "busses": s.busses.iter().map(|b| json!({"id": b.id, "name": b.name, "format": b.format.label()})).collect::<Vec<_>>(),
         "markers": s.markers.iter().map(|m| json!({"id": m.id, "number": m.number, "name": m.name, "kind": m.kind, "start": m.start, "end": m.end})).collect::<Vec<_>>(),
         "groups": s.groups.iter().map(|g| json!({"id": g.id, "name": g.name, "letter": g.letter, "members": g.members, "active": g.active})).collect::<Vec<_>>(),
-        "sources": s.sources.iter().map(|x| json!({"id": x.id, "name": x.name, "channels": x.channels, "frames": x.frames, "path": x.path})).collect::<Vec<_>>(),
+        "sources": s.sources.iter().map(|x| json!({
+            "id": x.id, "name": x.name, "channels": x.channels, "frames": x.frames, "path": x.path,
+            "loaded": s.pool.contains(x.id),
+        })).collect::<Vec<_>>(),
         "selection": {"start": s.edit.selection.start, "end": s.edit.selection.end, "tracks": s.edit.selected_tracks, "clips": s.edit.selected_clips},
         "edit_mode": s.edit.edit_mode, "tool": s.edit.tool, "grid": s.edit.grid.label(), "nudge": s.edit.nudge.label(),
         "transport": e.transport,
@@ -146,3 +149,25 @@ pub fn session_text(e: &Engine) -> String {
     }
     out
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use serde_json::json;
+
+    #[test]
+    fn sources_report_whether_audio_is_loaded() {
+        let mut e = crate::demo::demo_engine();
+        let before = session(&e, false);
+        let sources = before["sources"].as_array().expect("sources");
+        assert!(!sources.is_empty());
+        assert!(sources.iter().all(|s| s["loaded"] == true), "{sources:?}");
+
+        let id = e.session().sources[0].id;
+        assert!(e.session_mut().pool.remove(id).is_some());
+        let after = session(&e, false);
+        let entry = after["sources"].as_array().unwrap().iter().find(|s| s["id"] == json!(id)).expect("source still listed");
+        assert_eq!(entry["loaded"], false, "{entry}");
+        assert_eq!(entry["path"], before["sources"][0]["path"], "metadata stays even when unloaded");
+    }
+}

docs/control-protocol.md

@@ -30,7 +30,7 @@ Errors: `{"id": 1, "ok": false, "error": "bad parameters for `mix.volume`: no tr
 | `engine.execute` (alias `command`) | `{command, params}` | Run a command programmatically. **Never opens a dialog**; empty params use defaults or the current selection. |
 | `engine.commands` | `{filter?}` | Every command: id, label, menu path, shortcut, params doc, enabled + reason. Includes UI-layer commands (`window.*`). |
 | `engine.parity` | `{}` | Parity report against the incumbent's menu catalog. |
-| `session.inspect` | `{detail?: "summary"|"full"}` | The document: tracks, clips (with times), inserts (+params when full), sends, routing, automation, markers, groups, busses, sources, selection, transport, undo label. |
+| `session.inspect` | `{detail?: "summary"|"full"}` | The document: tracks, clips (with times), inserts (+params when full), sends, routing, automation, markers, groups, busses, sources (`loaded` true when decoded audio is in the pool), selection, transport, undo label. |
 | `ui.inspect` | `{}` | UI state (`window`, panels, dialogs), window size, playing/position, audio device, and `edit_layout` (timeline rect and every track row's rect, for clicking). |
 | `ui.set` | any `UiState` fields | e.g. `{"window": "Mix", "narrow_mix": true}`. |
 | `ui.menu.list` | `{}` | Every catalog menu path and the command that implements it (or null). |

docs/mcp.md

@@ -23,7 +23,7 @@ claude mcp add soundcraft -- soundcraft-cli mcp --demo
 | `list_commands` | Discover every command (id, label, menu path, shortcut, params doc, enabled). |
 | `execute` | Run one command with JSON params. |
 | `batch` | Run several commands in order (`keep_going` optional). |
-| `inspect_session` | Verify work: tracks, clips, mixer, plugins, sends, automation, markers, selection. |
+| `inspect_session` | Verify work: tracks, clips, mixer, plugins, sends, automation, markers, selection; each `sources[]` entry includes `loaded` (decoded audio in the pool). |
 | `new_session`, `open_session`, `save_session` | Session files (`.scraft`, audio in `Audio Files/`). `open_session` returns `missing`: the media files that could not be loaded (empty when all are found). |
 | `import_audio` | WAV, AIFF, FLAC, MP3, OGG, AAC/M4A, ALAC, CAF onto a new or existing track. |
 | `bounce_mix` | Render to WAV/AIFF/FLAC; returns peak dBFS and integrated LUFS. |