AquaSynth/tools/AquaSynthDaemon/Program.cs
2026-06-15 01:45:01 +01:00

393 lines
18 KiB
C#

using System.Text.Json;
using System.Text.Json.Serialization;
using AquaSynth.Faust;
var result = await AquaSynthDaemonCli.RunAsync(args, Console.In, Console.Out, Console.Error);
return result;
internal static class AquaSynthDaemonCli
{
private static readonly JsonSerializerOptions JsonOptions = new()
{
PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
WriteIndented = false
};
public static async Task<int> RunAsync(string[] args, TextReader input, TextWriter output, TextWriter error)
{
if (args.Length == 0 || args.Contains("--help", StringComparer.OrdinalIgnoreCase))
{
await WriteUsageAsync(output).ConfigureAwait(false);
return 0;
}
var mode = args[0].ToLowerInvariant();
var options = ParseOptions(args.Skip(1).ToArray());
var storeRoot = Value(options, "--store", Path.Combine(Environment.CurrentDirectory, ".aquasynth"));
var serviceOptions = new AquaSynthDaemonOptions(
storeRoot,
SampleRate: IntValue(options, "--sample-rate", 44100),
MinRenderSeconds: FloatValue(options, "--min-seconds", 0.05f),
MaxRenderSeconds: FloatValue(options, "--max-seconds", 3.0f));
using var service = new AquaSynthDaemonService(serviceOptions);
return mode switch
{
"once" => await RunOnceAsync(service, options, output).ConfigureAwait(false),
"stream" => await RunStreamOnceAsync(service, options, output).ConfigureAwait(false),
"daemon" => await RunDaemonAsync(service, input, output, error).ConfigureAwait(false),
"cultnet-once" => await RunCultNetOnceAsync(service, storeRoot, options, output).ConfigureAwait(false),
"cultnet-stream" => await RunCultNetStreamOnceAsync(service, storeRoot, options, output).ConfigureAwait(false),
"cultnet-daemon" => await RunCultNetDaemonAsync(service, storeRoot, input, output, error).ConfigureAwait(false),
"cultnet-host" => await RunCultNetHostAsync(service, storeRoot, output).ConfigureAwait(false),
_ => await UnknownModeAsync(mode, error).ConfigureAwait(false)
};
}
private static async Task<int> RunOnceAsync(
AquaSynthDaemonService service,
IReadOnlyDictionary<string, string> options,
TextWriter output)
{
var script = options.TryGetValue("--script", out var inlineScript)
? inlineScript
: await File.ReadAllTextAsync(Value(options, "--script-file", "")).ConfigureAwait(false);
var command = new AquaSynthInstrumentSampleCommand(
Value(options, "--command-id", $"cli-{DateTimeOffset.UtcNow:yyyyMMddHHmmssfff}"),
Value(options, "--patch-id", "cli.patch"),
Value(options, "--faust-name", "aquasynth_cli_patch"),
script,
FloatValue(options, "--duration", 0.25f),
FloatValue(options, "--gain", 1.0f),
ParseControls(Value(options, "--control", "")),
IntValue(options, "--revision", 1));
var result = await service.SampleAsync(command).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(result, JsonOptions)).ConfigureAwait(false);
return string.Equals(result.RenderReceipt.Status, "succeeded", StringComparison.Ordinal) ? 0 : 2;
}
private static async Task<int> RunStreamOnceAsync(
AquaSynthDaemonService service,
IReadOnlyDictionary<string, string> options,
TextWriter output)
{
var script = options.TryGetValue("--script", out var inlineScript)
? inlineScript
: await File.ReadAllTextAsync(Value(options, "--script-file", "")).ConfigureAwait(false);
var command = new AquaSynthAutomationStreamCommand(
Value(options, "--command-id", $"stream-{DateTimeOffset.UtcNow:yyyyMMddHHmmssfff}"),
Value(options, "--patch-id", "cli.stream.patch"),
Value(options, "--faust-name", "aquasynth_cli_stream"),
script,
IntValue(options, "--block-size", 128),
IntValue(options, "--blocks", 8),
ParseControlFrames(Value(options, "--control-frame", "")),
FloatValue(options, "--gain", 1.0f),
IntValue(options, "--revision", 1));
var receipt = await service.StreamAutomationAsync(command).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(receipt, JsonOptions)).ConfigureAwait(false);
return string.Equals(receipt.Status, "succeeded", StringComparison.Ordinal) ? 0 : 2;
}
private static async Task<int> RunDaemonAsync(
AquaSynthDaemonService service,
TextReader input,
TextWriter output,
TextWriter error)
{
string? line;
while ((line = await input.ReadLineAsync().ConfigureAwait(false)) is not null)
{
if (string.IsNullOrWhiteSpace(line))
{
continue;
}
try
{
line = line.TrimStart('\uFEFF').Trim();
var envelope = JsonSerializer.Deserialize<DaemonCommandEnvelope>(line, JsonOptions)
?? throw new InvalidOperationException("Command line did not contain a JSON object.");
if (string.Equals(envelope.Command, "patch.compile", StringComparison.OrdinalIgnoreCase))
{
var command = envelope.Payload.Deserialize<AquaSynthPatchCompileCommand>(JsonOptions)
?? throw new InvalidOperationException("patch.compile payload was empty.");
var receipt = await service.CompileAsync(command).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(receipt, JsonOptions)).ConfigureAwait(false);
}
else if (string.Equals(envelope.Command, "instrument.sample", StringComparison.OrdinalIgnoreCase))
{
var command = envelope.Payload.Deserialize<AquaSynthInstrumentSampleCommand>(JsonOptions)
?? throw new InvalidOperationException("instrument.sample payload was empty.");
var receipt = await service.SampleAsync(command).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(receipt, JsonOptions)).ConfigureAwait(false);
}
else if (string.Equals(envelope.Command, "instrument.stream", StringComparison.OrdinalIgnoreCase))
{
var command = envelope.Payload.Deserialize<AquaSynthAutomationStreamCommand>(JsonOptions)
?? throw new InvalidOperationException("instrument.stream payload was empty.");
var receipt = await service.StreamAutomationAsync(command).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(receipt, JsonOptions)).ConfigureAwait(false);
}
else
{
throw new InvalidOperationException($"Unknown command '{envelope.Command}'.");
}
}
catch (Exception ex)
{
await error.WriteLineAsync(ex.Message).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(new
{
status = "failed",
failureCode = "command_failed",
failureMessage = ex.Message
}, JsonOptions)).ConfigureAwait(false);
}
}
return 0;
}
private static async Task<int> RunCultNetOnceAsync(
AquaSynthDaemonService service,
string storeRoot,
IReadOnlyDictionary<string, string> options,
TextWriter output)
{
var script = options.TryGetValue("--script", out var inlineScript)
? inlineScript
: await File.ReadAllTextAsync(Value(options, "--script-file", "")).ConfigureAwait(false);
await using var cultNet = await AquaSynthCultNetDaemon.StartAsync(
new AquaSynthCultNetDaemonOptions(storeRoot),
service).ConfigureAwait(false);
var receipt = await cultNet.SubmitSampleAsync(new AquaSynthInstrumentSampleCommand(
Value(options, "--command-id", $"cultnet-{DateTimeOffset.UtcNow:yyyyMMddHHmmssfff}"),
Value(options, "--patch-id", "cultnet.patch"),
Value(options, "--faust-name", "aquasynth_cultnet_patch"),
script,
FloatValue(options, "--duration", 0.25f),
FloatValue(options, "--gain", 1.0f),
ParseControls(Value(options, "--control", "")),
IntValue(options, "--revision", 1))).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(receipt, JsonOptions)).ConfigureAwait(false);
return string.Equals(receipt.Status, "succeeded", StringComparison.Ordinal) ? 0 : 2;
}
private static async Task<int> RunCultNetStreamOnceAsync(
AquaSynthDaemonService service,
string storeRoot,
IReadOnlyDictionary<string, string> options,
TextWriter output)
{
var script = options.TryGetValue("--script", out var inlineScript)
? inlineScript
: await File.ReadAllTextAsync(Value(options, "--script-file", "")).ConfigureAwait(false);
await using var cultNet = await AquaSynthCultNetDaemon.StartAsync(
new AquaSynthCultNetDaemonOptions(storeRoot),
service).ConfigureAwait(false);
var receipt = await cultNet.SubmitStreamAsync(new AquaSynthAutomationStreamCommand(
Value(options, "--command-id", $"cultnet-stream-{DateTimeOffset.UtcNow:yyyyMMddHHmmssfff}"),
Value(options, "--patch-id", "cultnet.stream.patch"),
Value(options, "--faust-name", "aquasynth_cultnet_stream"),
script,
IntValue(options, "--block-size", 128),
IntValue(options, "--blocks", 8),
ParseControlFrames(Value(options, "--control-frame", "")),
FloatValue(options, "--gain", 1.0f),
IntValue(options, "--revision", 1))).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(receipt, JsonOptions)).ConfigureAwait(false);
return string.Equals(receipt.Status, "succeeded", StringComparison.Ordinal) ? 0 : 2;
}
private static async Task<int> RunCultNetDaemonAsync(
AquaSynthDaemonService service,
string storeRoot,
TextReader input,
TextWriter output,
TextWriter error)
{
await using var cultNet = await AquaSynthCultNetDaemon.StartAsync(
new AquaSynthCultNetDaemonOptions(storeRoot),
service).ConfigureAwait(false);
string? line;
while ((line = await input.ReadLineAsync().ConfigureAwait(false)) is not null)
{
if (string.IsNullOrWhiteSpace(line))
{
continue;
}
try
{
line = line.TrimStart('\uFEFF').Trim();
var envelope = JsonSerializer.Deserialize<DaemonCommandEnvelope>(line, JsonOptions)
?? throw new InvalidOperationException("Command line did not contain a JSON object.");
if (string.Equals(envelope.Command, "patch.compile", StringComparison.OrdinalIgnoreCase))
{
var command = envelope.Payload.Deserialize<AquaSynthPatchCompileCommand>(JsonOptions)
?? throw new InvalidOperationException("patch.compile payload was empty.");
var receipt = await cultNet.SubmitCompileAsync(command).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(receipt, JsonOptions)).ConfigureAwait(false);
}
else if (string.Equals(envelope.Command, "instrument.sample", StringComparison.OrdinalIgnoreCase))
{
var command = envelope.Payload.Deserialize<AquaSynthInstrumentSampleCommand>(JsonOptions)
?? throw new InvalidOperationException("instrument.sample payload was empty.");
var receipt = await cultNet.SubmitSampleAsync(command).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(receipt, JsonOptions)).ConfigureAwait(false);
}
else if (string.Equals(envelope.Command, "instrument.stream", StringComparison.OrdinalIgnoreCase))
{
var command = envelope.Payload.Deserialize<AquaSynthAutomationStreamCommand>(JsonOptions)
?? throw new InvalidOperationException("instrument.stream payload was empty.");
var receipt = await cultNet.SubmitStreamAsync(command).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(receipt, JsonOptions)).ConfigureAwait(false);
}
else
{
throw new InvalidOperationException($"Unknown command '{envelope.Command}'.");
}
}
catch (Exception ex)
{
await error.WriteLineAsync(ex.Message).ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(new
{
status = "failed",
failureCode = "command_failed",
failureMessage = ex.Message
}, JsonOptions)).ConfigureAwait(false);
}
}
return 0;
}
private static async Task<int> RunCultNetHostAsync(
AquaSynthDaemonService service,
string storeRoot,
TextWriter output)
{
await using var cultNet = await AquaSynthCultNetDaemon.StartAsync(
new AquaSynthCultNetDaemonOptions(storeRoot),
service).ConfigureAwait(false);
var provider = await cultNet.Database
.GetAsync<AquaSynthCultNetProviderState>(new GameCult.Caching.CultRecordKey("global:aquasynth.cultnet_provider"))
.ConfigureAwait(false);
await output.WriteLineAsync(JsonSerializer.Serialize(provider, JsonOptions)).ConfigureAwait(false);
await Task.Delay(Timeout.InfiniteTimeSpan).ConfigureAwait(false);
return 0;
}
private static async Task<int> UnknownModeAsync(string mode, TextWriter error)
{
await error.WriteLineAsync($"Unknown AquaSynth daemon mode '{mode}'.").ConfigureAwait(false);
return 64;
}
private static async Task WriteUsageAsync(TextWriter output)
{
await output.WriteLineAsync("""
AquaSynthDaemon
once --script-file patch.aqua [--store .aquasynth] [--duration 0.25] [--gain 1]
stream --script-file patch.aqua [--store .aquasynth] [--block-size 128] [--blocks 8]
daemon [--store .aquasynth]
cultnet-once --script-file patch.aqua [--store .aquasynth] [--duration 0.25] [--gain 1]
cultnet-stream --script-file patch.aqua [--store .aquasynth] [--block-size 128] [--blocks 8]
cultnet-daemon [--store .aquasynth]
cultnet-host [--store .aquasynth]
JSON-lines daemon commands:
{"command":"instrument.sample","payload":{"commandId":"demo","patchId":"demo.patch","faustName":"demo","script":"voice wave=sine freq=440 gain=.2","durationSeconds":0.1}}
{"command":"instrument.stream","payload":{"commandId":"demo-stream","patchId":"demo.patch","faustName":"demo","script":"param path=/macro/gain default=.2 min=0 max=1 step=.001; voice wave=sine freq=440 gain=@/macro/gain","blockSize":128,"blockCount":4,"controlFrames":[{"block":1,"controls":{"/macro/gain":0.05}}]}}
""").ConfigureAwait(false);
}
private static IReadOnlyDictionary<string, string> ParseOptions(string[] args)
{
var options = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
for (var index = 0; index < args.Length; index++)
{
var key = args[index];
if (!key.StartsWith("--", StringComparison.Ordinal))
{
continue;
}
options[key] = index + 1 < args.Length && !args[index + 1].StartsWith("--", StringComparison.Ordinal)
? args[++index]
: "true";
}
return options;
}
private static string Value(IReadOnlyDictionary<string, string> options, string key, string fallback) =>
options.TryGetValue(key, out var value) && !string.IsNullOrWhiteSpace(value) ? value : fallback;
private static int IntValue(IReadOnlyDictionary<string, string> options, string key, int fallback) =>
options.TryGetValue(key, out var value) && int.TryParse(value, out var parsed) ? parsed : fallback;
private static float FloatValue(IReadOnlyDictionary<string, string> options, string key, float fallback) =>
options.TryGetValue(key, out var value) && float.TryParse(value, out var parsed) ? parsed : fallback;
private static Dictionary<string, float>? ParseControls(string value)
{
if (string.IsNullOrWhiteSpace(value))
{
return null;
}
var controls = new Dictionary<string, float>(StringComparer.OrdinalIgnoreCase);
foreach (var assignment in value.Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries))
{
var parts = assignment.Split('=', 2, StringSplitOptions.TrimEntries);
if (parts.Length == 2 && float.TryParse(parts[1], out var parsed))
{
controls[parts[0]] = parsed;
}
}
return controls;
}
private static AquaSynthAutomationControlFrame[]? ParseControlFrames(string value)
{
if (string.IsNullOrWhiteSpace(value))
{
return null;
}
var frames = new List<AquaSynthAutomationControlFrame>();
foreach (var frameSpec in value.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries))
{
var parts = frameSpec.Split(':', 2, StringSplitOptions.TrimEntries);
if (parts.Length != 2 || !int.TryParse(parts[0], out var block))
{
continue;
}
var controls = ParseControls(parts[1]);
if (controls is { Count: > 0 })
{
frames.Add(new AquaSynthAutomationControlFrame(block, controls));
}
}
return frames.Count == 0 ? null : [.. frames];
}
private sealed record DaemonCommandEnvelope(string Command, JsonElement Payload);
}