Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.
C# audioaudio-unitavaloniacpp20cross-platformdawdigital-audio-workstationdspjucelinux-audiomcp-servermidimusicmusic-productionpiano-rollplugin-hostsequencersynthesizervstvst3
// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (c) 2026 Egor Khindikaynen (Nota). See LICENSES/ for license terms.
namespace Nota.Mcp;
/// <summary>Marshals engine access onto the UI/message thread that owns <c>IAudioEngine</c>.
/// MCP tool handlers run on Kestrel request threads; every engine call must go through this.
/// Also serializes concurrent MCP calls (single UI thread) — no engine re-entrancy.
/// Implemented by Nota.App via Avalonia's Dispatcher; the tests use a synchronous stub.</summary>
public interface IEngineDispatch
{
Task<T> InvokeAsync<T>(Func<T> func);
Task InvokeAsync(Action action);
}
/// <summary>Raised after a mutating tool so the arrangement + device panel redraw and the user
/// sees AI edits live. Nota.App wires this to Timeline/DeviceChain refresh; no-op in tests.</summary>
public interface IArrangementRefresh
{
void Refresh();
}
/// <summary>One learned MIDI mapping, flattened for the MCP tools.</summary>
public readonly record struct MidiMappingInfo(
int Index, string Control, string SourceKind, int Channel, int Number,
double RangeMin, double RangeMax, bool Invert, string Source);
/// <summary>A distinct controller source seen recently (for discovery), value 0..127.</summary>
public readonly record struct MidiControlSeen(string Kind, int Channel, int Number, int LastValue, int Count);
/// <summary>Facade over the app's MIDI-learn service so the MCP tools can inspect connected
/// controllers, view/manage learned mappings, and arm learn — without referencing Nota.App.
/// Implemented in Nota.App over MidiLearnService; every call runs on the engine's UI thread.</summary>
public interface IMidiLearnAccess
{
/// <summary>Learn mode: mappable controls highlight and a click selects a target to bind.</summary>
bool Armed { get; set; }
IReadOnlyList<MidiMappingInfo> Mappings();
bool RemoveMapping(int index);
void ClearMappings();
bool SetMappingRange(int index, double rangeMin, double rangeMax, bool invert);
IReadOnlyList<MidiControlSeen> RecentControls();
void ClearRecentControls();
}
/// <summary>Facade over the open project for the version-history tools: what is open, whether
/// it has unsaved edits, and the two actions that go through the window (save, switch) —
/// without referencing Nota.App. Implemented in Nota.App over MainWindow; every member runs on
/// the UI thread (call it inside <see cref="IEngineDispatch.InvokeAsync{T}"/>).</summary>
public interface IProjectVersionsAccess
{
/// <summary>The open <c>.nota</c> bundle, or null while the project has never been saved.</summary>
string? ProjectPath { get; }
bool HasUnsavedChanges { get; }
/// <summary>Settings → Version history.</summary>
bool HistoryEnabled { get; }
/// <summary>Saves the project in place, recording a version (with the note, if any).
/// False when it couldn't be saved.</summary>
Task<bool> SaveVersionAsync(string? note);
/// <summary>Restores a version into the bundle and reopens the project, discarding unsaved
/// edits (the caller checked). False if it couldn't switch.</summary>
Task<bool> SwitchToVersionAsync(string versionId);
/// <summary>A tool changed the history directly (a label, note or star): redraw the History tab.</summary>
void NotifyHistoryChanged();
}
/// <summary>The project key (lives on the app's transport, not in the engine), for the
/// smart-sample tools. A <c>MusicalKey.Code</c>, −1 = none. Runs on the UI thread.</summary>
public interface IProjectKeyAccess
{
int KeyCode { get; set; }
}
/// <summary>Facade over the app's colour themes for the theme tools (spec 087): list, read,
/// validate, preview, save, wear and try on themes — without referencing Nota.App. Implemented
/// in Nota.App over NotaThemes / NotaThemeService; every member runs on the UI thread (call it
/// inside <see cref="IEngineDispatch.InvokeAsync{T}"/>).</summary>
public interface IThemeAccess
{
ThemeListing List();
/// <summary>A listed theme's file text (format 1–3), or null for an unknown id. With
/// <paramref name="look"/> "classic", a built-in's classic palette (spec 091).</summary>
string? GetFile(string id, string? look = null);
ThemeCatalogue Catalogue();
IReadOnlyList<string> SystemFonts();
Nota.Application.Themes.ThemeValidation Validate(string json);
/// <summary>Images of <paramref name="json"/> worn on the named surfaces (all when null),
/// rendered offscreen; the live window does not change. Nothing is rendered for an invalid theme.</summary>
Task<ThemePreviews> PreviewAsync(string json, IReadOnlyList<string>? surfaces, bool themeAccent, string? look = null);
ThemeSaveResult Save(string json, bool overwrite);
/// <summary>Wear a listed theme and store it, as a pick in Preferences. Null, or why not.</summary>
string? Apply(string id);
/// <summary>Wear <paramref name="json"/> live without storing it. Whether it is worn.</summary>
bool TryOn(string json, out Nota.Application.Themes.ThemeValidation validation);
/// <summary>End a try-on; the id worn afterwards.</summary>
string RevertTryOn();
/// <summary>Wear and store a look ("new" | "classic", spec 091), as Preferences does; the id
/// worn afterwards. An unknown look throws ArgumentException naming the allowed ones.</summary>
string SetLook(string look);
}
public sealed record ThemeListing(ThemeListEntry[] Themes, string Worn, bool TryOn, ThemeChoiceInfo Choice, ThemeFileProblem[] Problems);
public sealed record ThemeListEntry(string Id, string Name, string Kind, string Source, int Warnings, bool FontMissing,
string? FontFamily, double Roundness);
public sealed record ThemeChoiceInfo(bool FollowSystem, string Single, string Dark, string Light, string Look);
public sealed record ThemeFileProblem(string File, string Reason);
public sealed record ThemeTokenInfo(string Name, string Group, string Role, bool Translucent);
public sealed record ThemeRadiusStepInfo(string Name, double Design);
/// <summary>The accepted limits, each as [min, max]: radius scale, a radius step in px, the font family name's length.</summary>
public sealed record ThemeRanges(double[] Scale, double[] Step, int[] FontFamilyLength);
public sealed record ThemeCatalogue(ThemeTokenInfo[] Tokens, ThemeRadiusStepInfo[] RadiusSteps, ThemeRanges Ranges, int[] FormatVersions);
public sealed record ThemePreviewImage(string Name, string Description, byte[] Png);
public sealed record ThemePreviews(Nota.Application.Themes.ThemeValidation Validation, ThemePreviewImage[] Images,
string[] Rendered, string[] Unknown);
public sealed record ThemeSaveResult(Nota.Application.Themes.ThemeValidation Validation, bool Saved, string? File, string? Reason);