shared: add independent IPv4 and IPv6 collection [CI]

backend/src/MoShiro.Backend.Application/Agents/AgentEventService.cs

@@ -34,11 +34,11 @@ public sealed class AgentEventService
         switch (e.Kind)
         {
             case AgentEventKinds.ProbeConnected when !string.IsNullOrEmpty(e.Detail):
-                state.AddProbe(e.Probe is { } p ? new ConnectedProbeInfo(e.Detail, p.Version, p.Remote, p.SinceUtcMs > 0 ? p.SinceUtcMs : at) : new ConnectedProbeInfo(e.Detail, null, null, at));
+                state.AddProbe(e.Probe is { } p ? new ConnectedProbeInfo(e.Detail, p.Version, p.Remote, p.SinceUtcMs > 0 ? p.SinceUtcMs : at, p.IpVersion) : new ConnectedProbeInfo(e.Detail, null, null, at));
                 _nodes.ObserveProbeInBackground(e.Detail, e.Probe?.Remote);
                 break;
             case AgentEventKinds.ProbeDisconnected when !string.IsNullOrEmpty(e.Detail):
-                state.RemoveProbe(e.Detail);
+                state.RemoveProbe(e.Detail, e.Probe?.IpVersion ?? IpVersions.V4);
                 break;
             case AgentEventKinds.EndpointChanged:
                 state.CountEndpointChange();

backend/src/MoShiro.Backend.Application/Agents/AgentRuntime.cs

@@ -5,7 +5,7 @@ using MoShiro.Protocol;
 namespace MoShiro.Backend.Application;
 
 /// <summary>Agent 眼中的一个已连接 Probe（Agent 在事件和心跳里上报）。</summary>
-public sealed record ConnectedProbeInfo(string Id, string? Version, string? Remote, long SinceMs);
+public sealed record ConnectedProbeInfo(string Id, string? Version, string? Remote, long SinceMs, string IpVersion = IpVersions.V4);
 
 /// <summary>Agent 的运行时状态（只在内存中）：连着哪些 Probe、最近的进程内计数、端点变化次数。</summary>
 public sealed class AgentRuntimeState
@@ -19,22 +19,22 @@ public sealed class AgentRuntimeState
 
     public bool ProbeConnected => Probes.Count > 0;
 
-    public bool IsConnected(string probeId) => Probes.Any(p => p.Id == probeId);
+    public bool IsConnected(string probeId, string ipVersion = IpVersions.V4) => Probes.Any(p => p.Id == probeId && p.IpVersion == ipVersion);
 
     /// <summary>事件 <c>probe_connected</c>：事件里带着 Probe 的版本和地址；心跳里的完整快照随后会再校正一次。</summary>
     public void AddProbe(ConnectedProbeInfo info)
     {
         lock (_gate)
         {
-            Volatile.Write(ref _probes, [.. _probes.Where(p => p.Id != info.Id), info]);
+            Volatile.Write(ref _probes, [.. _probes.Where(p => p.Id != info.Id || p.IpVersion != info.IpVersion), info]);
         }
     }
 
-    public void RemoveProbe(string id)
+    public void RemoveProbe(string id, string ipVersion = IpVersions.V4)
     {
         lock (_gate)
         {
-            Volatile.Write(ref _probes, [.. _probes.Where(p => p.Id != id)]);
+            Volatile.Write(ref _probes, [.. _probes.Where(p => p.Id != id || p.IpVersion != ipVersion)]);
         }
     }
 

backend/src/MoShiro.Backend.Application/Agents/AgentService.cs

@@ -1,3 +1,5 @@
+using System.Net;
+using System.Net.Sockets;
 using System.Text.RegularExpressions;
 using Fleet.Core;
 using Fleet.Server;
@@ -49,6 +51,16 @@ public sealed partial class AgentService
         return new AgentView(agent, _gateway.IsOnline(agent.Id), state?.Probes ?? [], state?.LastHeartbeat, state?.EndpointChanges ?? 0, state?.LastHeartbeatAtMs, state?.Host);
     }
 
+    private static bool ValidHost(string host, string ipVersion)
+    {
+        if (IPAddress.TryParse(host, out IPAddress? address))
+        {
+            return !address.IsIPv4MappedToIPv6 && address.AddressFamily == (ipVersion == IpVersions.V6 ? AddressFamily.InterNetworkV6 : AddressFamily.InterNetwork);
+        }
+
+        return host.Length <= 253 && Uri.CheckHostName(host) == UriHostNameType.Dns;
+    }
+
     public async ValueTask<Result<AgentView>> PatchAsync(NodeId id, AgentPatch patch, long? expectedRowVersion, CancellationToken ct)
     {
         var errors = new Dictionary<string, string>();
@@ -57,11 +69,16 @@ public sealed partial class AgentService
             errors["name"] = "must be 1-64 characters: letters (any language), digits, '.', '_' or '-'";
         }
 
-        if (patch.PublicHost is not null && !HostPattern().IsMatch(patch.PublicHost))
+        if (patch.PublicHost is not null && !ValidHost(patch.PublicHost, IpVersions.V4))
         {
             errors["public_host"] = "must be a host name or IP address";
         }
 
+        if (patch.Ipv6Host is not null && patch.Ipv6Host.Length > 0 && !ValidHost(patch.Ipv6Host, IpVersions.V6))
+        {
+            errors["ipv6_host"] = "must be an IPv6 address or host name; empty disables IPv6 collection";
+        }
+
         if (patch.Labels is not null && (patch.Labels.Count > 16 || patch.Labels.Any(l => l.Length is 0 or > 32)))
         {
             errors["labels"] = "at most 16 labels of 1-32 characters";
@@ -78,7 +95,7 @@ public sealed partial class AgentService
             return Result<AgentView>.Fail(error);
         }
 
-        if (patch.Name is not null || patch.PublicHost is not null)
+        if (patch.Name is not null || patch.PublicHost is not null || patch.Ipv6Host is not null)
         {
             await AfterAgentSetChangedAsync(ct);
         }
@@ -139,6 +156,7 @@ public sealed partial class AgentService
                 AgentId = agent.Id,
                 Name = agent.Name,
                 Host = agent.PublicHost,
+                Ipv6Host = agent.Ipv6Supported && agent.Ipv6Host.Length > 0 ? agent.Ipv6Host : null,
                 TcpPort = agent.ProbeTcpPort,
                 UdpPorts = [.. agent.ProbeUdpPorts],
                 Spki = Convert.ToBase64String(agent.TlsSpki),
@@ -170,7 +188,4 @@ public sealed partial class AgentService
 
     [GeneratedRegex(@"^[\p{L}\p{M}\p{N}._-]{1,64}$")]
     private static partial Regex NamePattern();
-
-    [GeneratedRegex(@"^[A-Za-z0-9.:\-\[\]]{1,253}$")]
-    private static partial Regex HostPattern();
 }

backend/src/MoShiro.Backend.Application/Agents/MoShiroFleetHooks.cs

@@ -99,7 +99,7 @@ public sealed class MoShiroNodeEventSink : INodeEventSink
                     _releases.RecordStatus(id, beat?.Update);
                     if (beat is not null)
                     {
-                        state.ReplaceProbes(beat.Probes.Select(p => new ConnectedProbeInfo(p.Id.Value, p.Version, p.Remote, p.SinceUtcMs)));
+                        state.ReplaceProbes(beat.Probes.Select(p => new ConnectedProbeInfo(p.Id.Value, p.Version, p.Remote, p.SinceUtcMs, p.IpVersion)));
                         foreach (ConnectedProbe p in beat.Probes)
                         {
                             _nodes.ObserveProbeInBackground(p.Id.Value, p.Remote);
@@ -196,14 +196,14 @@ public sealed class MoShiroNodeEventSink : INodeEventSink
 
         AgentRecord? before = await _agents.GetAsync(id, ct);
         string? limitsJson = meta.LocalLimits is null ? null : JsonSerializer.Serialize(meta.LocalLimits, LocalLimitsJson.Default.LocalLimits);
-        await _agents.ApplyHelloAsync(id, new AgentHello(kinds, hello.NodeVersion, limitsJson, spki is { Length: 32 } ? spki : null, meta.ProbeTcpPort, meta.ProbeUdpPorts), ct);
+        await _agents.ApplyHelloAsync(id, new AgentHello(kinds, hello.NodeVersion, limitsJson, spki is { Length: 32 } ? spki : null, meta.ProbeTcpPort, meta.ProbeUdpPorts, meta.Ipv6Supported), ct);
 
         // 端口或证书指纹变了，Probe 需要新的列表
         AgentRecord? after = await _agents.GetAsync(id, ct);
         _nodes.ObserveAgentInBackground(id.Value, after?.PublicHost, meta.Platform);
         await _releases.OfferToNodeAsync(id, ct);
         if (before is not null && after is not null
-            && (!before.TlsSpki.AsSpan().SequenceEqual(after.TlsSpki) || before.ProbeTcpPort != after.ProbeTcpPort || !before.ProbeUdpPorts.SequenceEqual(after.ProbeUdpPorts))
+            && (!before.TlsSpki.AsSpan().SequenceEqual(after.TlsSpki) || before.ProbeTcpPort != after.ProbeTcpPort || !before.ProbeUdpPorts.SequenceEqual(after.ProbeUdpPorts) || before.Ipv6Supported != after.Ipv6Supported)
             && after.Status == NodeStatus.Active)
         {
             await _service.AfterAgentSetChangedAsync(ct);

backend/src/MoShiro.Backend.Application/Agents/ProbeService.cs

@@ -13,7 +13,7 @@ public sealed record ProbeLimits(double MaxTestMbps, long MaxTotalPps);
 public sealed record ProbeIdentityFile(ProbeId ProbeId, string PrivateKey, string Server, ProbeLimits Limits);
 
 /// <summary>某个 Probe 现在连着的一个 Agent（Agent 上报）。</summary>
-public sealed record ProbeConnection(NodeId AgentId, string AgentName, bool AgentOnline, string? Version, string? Remote, long SinceMs);
+public sealed record ProbeConnection(NodeId AgentId, string AgentName, bool AgentOnline, string? Version, string? Remote, long SinceMs, string IpVersion = IpVersions.V4);
 
 public sealed record ProbeView(ProbeRecord Probe, bool Online, IReadOnlyList<ProbeConnection> Connections)
 {
@@ -178,7 +178,7 @@ public sealed partial class ProbeService
             AgentRecord? agent = agents.FirstOrDefault(a => a.Id == agentId);
             if (agent is not null)
             {
-                connections.Add(new ProbeConnection(agentId, agent.Name, _gateway.IsOnline(agentId), info.Version, info.Remote, info.SinceMs));
+                connections.Add(new ProbeConnection(agentId, agent.Name, _gateway.IsOnline(agentId), info.Version, info.Remote, info.SinceMs, info.IpVersion));
             }
         }
 

backend/src/MoShiro.Backend.Application/Ingest/IngestService.cs

@@ -69,7 +69,8 @@ public sealed partial class IngestService
         RawChunkHeader header = chunk.Header;
         long now = _time.GetUtcNow().ToUnixTimeMilliseconds();
         string? problem =
-            header.AgentId != agent ? "agent_id does not match the authenticated node"
+            !IpVersions.IsValid(header.IpVersion) ? "unknown ip_version"
+            : header.AgentId != agent ? "agent_id does not match the authenticated node"
             : header.ChunkId.Value != msgId ? "chunk_id does not match the message id"
             : Kinds.Find(header.Kind) is null ? $"unknown kind {header.Kind}"
             : header.DurationMs is <= 0 or > MaxDurationMs ? "duration out of range"

backend/src/MoShiro.Backend.Application/Models/AgentModels.cs

@@ -22,7 +22,9 @@ public sealed record AgentRecord(
     string? RejectedJson,
     long CreatedAtMs,
     long? LastSeenAtMs,
-    long RowVersion);
+    long RowVersion,
+    string Ipv6Host = "",
+    bool Ipv6Supported = false);
 
 /// <summary>管理员可以修改的字段（merge-patch 语义：为 null 的字段不改）。</summary>
 public sealed class AgentPatch
@@ -33,6 +35,8 @@ public sealed class AgentPatch
 
     public string? PublicHost { get; init; }
 
+    public string? Ipv6Host { get; init; }
+
     public bool? PublicVisible { get; init; }
 }
 
@@ -43,7 +47,8 @@ public sealed record AgentHello(
     string? LocalLimitsJson,
     byte[]? TlsSpki,
     int? ProbeTcpPort,
-    IReadOnlyList<int>? ProbeUdpPorts);
+    IReadOnlyList<int>? ProbeUdpPorts,
+    bool Ipv6Supported = false);
 
 /// <summary>注册之后 MoShiro 的补充：公开地址和端口。</summary>
 public sealed record AgentEnrollment(string PublicHost, int ProbeTcpPort, IReadOnlyList<int> ProbeUdpPorts, IReadOnlyList<string> Kinds);

backend/src/MoShiro.Backend.Application/Models/TaskAndTestModels.cs

@@ -30,7 +30,8 @@ public sealed record TestRecord(
     int PhaseCount,
     long RequestedAtMs,
     long? StartedAtMs,
-    long? FinishedAtMs);
+    long? FinishedAtMs,
+    string IpVersion = IpVersions.V4);
 
 /// <summary>测试结果：指标与曲线都以 JSON 保存。</summary>
 public sealed record TestResultRecord(TestId TestId, byte[] MetricsJson, byte[] SeriesJson);

backend/src/MoShiro.Backend.Application/Ports/StorePorts.cs

@@ -108,6 +108,8 @@ public interface ITestStore
 
     ValueTask<IReadOnlyList<TestRecord>> ListAsync(NodeId? agentId, ProbeId? probeId, int limit, CancellationToken ct);
 
+    ValueTask<IReadOnlyList<TestRecord>> ListAsync(NodeId? agentId, ProbeId? probeId, int limit, string? ipVersion, CancellationToken ct);
+
     ValueTask<bool> UpdateStatusAsync(TestId id, string status, int? phase, string? errorCode, long nowMs, CancellationToken ct);
 
     ValueTask SetPhaseCountAsync(TestId id, int phaseCount, CancellationToken ct);

backend/src/MoShiro.Backend.Application/Query/Lines.cs

@@ -3,35 +3,35 @@ using MoShiro.Protocol;
 
 namespace MoShiro.Backend.Application;
 
-/// <summary>一条线路 = 一对（Agent，Probe）。存储里它的序列是 <c>line:&lt;probe_id&gt;</c>，对外的 id 是 <c>&lt;agent_id&gt;~&lt;probe_id&gt;</c>。</summary>
-public readonly record struct LineKey(NodeId Agent, ProbeId Probe)
+/// <summary>线路按（Agent，Probe，地址族）隔离。IPv4 保留 <c>agent~probe</c> 和 <c>line:probe</c>；IPv6 分别追加 <c>~ipv6</c>、<c>:ipv6</c>。</summary>
+public readonly record struct LineKey(NodeId Agent, ProbeId Probe, string IpVersion = IpVersions.V4)
 {
-    public string Series => RawChunkHeader.LinePrefix + Probe.Value;
+    public string Series => IpVersions.LineSeries(Probe.Value, IpVersion);
 
-    public string Id => Agent.Value + "~" + Probe.Value;
+    public string Id => Agent.Value + "~" + Probe.Value + (IpVersion == IpVersions.V6 ? "~ipv6" : "");
 
     public static bool TryParse(string text, out LineKey key)
     {
-        int split = text.IndexOf('~', StringComparison.Ordinal);
-        if (split <= 0 || split == text.Length - 1)
+        string[] parts = text.Split('~');
+        if (parts.Length is < 2 or > 3 || parts[0].Length == 0 || parts[1].Length == 0 || (parts.Length == 3 && parts[2] != IpVersions.V6))
         {
             key = default;
             return false;
         }
 
-        key = new LineKey(new NodeId(text[..split]), new ProbeId(text[(split + 1)..]));
+        key = new LineKey(new NodeId(parts[0]), new ProbeId(parts[1]), parts.Length == 3 ? IpVersions.V6 : IpVersions.V4);
         return true;
     }
 }
 
 /// <summary>一条线路的展示视图：Agent 的状态、Probe 记录，以及这一对现在是否连着。</summary>
-public sealed record LineView(AgentView Agent, ProbeRecord Probe)
+public sealed record LineView(AgentView Agent, ProbeRecord Probe, string IpVersion = IpVersions.V4)
 {
-    public LineKey Key => new(Agent.Agent.Id, new ProbeId(Probe.Id));
+    public LineKey Key => new(Agent.Agent.Id, new ProbeId(Probe.Id), IpVersion);
 
-    public bool Connected => Agent.Probes.Any(p => p.Id == Probe.Id);
+    public bool Connected => Agent.Probes.Any(p => p.Id == Probe.Id && p.IpVersion == IpVersion);
 
-    public ConnectedProbeInfo? Connection => Agent.Probes.FirstOrDefault(p => p.Id == Probe.Id);
+    public ConnectedProbeInfo? Connection => Agent.Probes.FirstOrDefault(p => p.Id == Probe.Id && p.IpVersion == IpVersion);
 }
 
 /// <summary>线路目录：把 id 解析成（Agent，Probe），列出所有线路。</summary>
@@ -54,7 +54,20 @@ public sealed class LineService
         IReadOnlyList<AgentView> agents = await _agents.ListAsync(ct);
         IReadOnlyList<ProbeRecord> probes = [.. (await _probes.ListAsync(ct)).Where(p => p.RevokedAtMs is null)];
         LinkSnapshot links = await _links.SnapshotAsync(ct);
-        return [.. agents.Where(include).SelectMany(a => probes.Where(p => links.IsLinked(p.Id, a.Agent.Id.Value)).Select(p => new LineView(a, p)))];
+        var result = new List<LineView>();
+        foreach (AgentView agent in agents.Where(include))
+        {
+            foreach (ProbeRecord probe in probes.Where(p => links.IsLinked(p.Id, agent.Agent.Id.Value)))
+            {
+                result.Add(new LineView(agent, probe));
+                if (agent.Agent.Ipv6Host.Length > 0)
+                {
+                    result.Add(new LineView(agent, probe, IpVersions.V6));
+                }
+            }
+        }
+
+        return result;
     }
 
     /// <summary>
@@ -64,6 +77,7 @@ public sealed class LineService
     {
         string agentPart = id;
         string? probePart = null;
+        string ipVersion = IpVersions.V4;
         if (id.Contains('~', StringComparison.Ordinal))
         {
             if (!LineKey.TryParse(id, out LineKey key))
@@ -73,6 +87,7 @@ public sealed class LineService
 
             agentPart = key.Agent.Value;
             probePart = key.Probe.Value;
+            ipVersion = key.IpVersion;
         }
 
         AgentView? agent = await _agents.GetAsync(new NodeId(agentPart), ct);
@@ -102,6 +117,6 @@ public sealed class LineService
             probe = active[0];
         }
 
-        return Result<LineView>.Ok(new LineView(agent, probe));
+        return Result<LineView>.Ok(new LineView(agent, probe, ipVersion));
     }
 }

backend/src/MoShiro.Backend.Application/Query/QueryService.cs

@@ -167,7 +167,7 @@ public sealed class QueryService
             }
 
             IReadOnlyDictionary<string, double> overlay = selection.WantsScores ? await TestOverlayAsync(line.Key, ct) : new Dictionary<string, double>();
-            IReadOnlyList<TestRecord> recent = await _tests.ListAsync(line.Key.Agent, line.Key.Probe, 1, ct);
+            IReadOnlyList<TestRecord> recent = await _tests.ListAsync(line.Key.Agent, line.Key.Probe, 1, line.Key.IpVersion, ct);
             result.Add(new OverviewLine(line, Summarize(merged, count, p.Plan, p.Range, selection, overlay), recent.Count > 0 ? recent[0] : null));
         }
 
@@ -372,7 +372,7 @@ public sealed class QueryService
         long cutoff = _time.GetUtcNow().ToUnixTimeMilliseconds() - (7 * Steps.Day);
         var overlay = new Dictionary<string, double>(StringComparer.Ordinal);
         var seenPlans = new HashSet<string>();
-        foreach (TestRecord test in await _tests.ListAsync(line.Agent, line.Probe, 20, ct))
+        foreach (TestRecord test in await _tests.ListAsync(line.Agent, line.Probe, 20, line.IpVersion, ct))
         {
             if (test.Status != TestStatuses.Succeeded || test.FinishedAtMs is not { } finished || finished < cutoff || !seenPlans.Add(test.Plan))
             {

backend/src/MoShiro.Backend.Application/Query/RowLoader.cs

@@ -139,7 +139,8 @@ public sealed class RowLoader
             IReadOnlyList<MetricRow> all = await _metrics.ReadAgentsAsync(ToLevel(plan.Source), agents, bySeries.Key, range.FromMs, range.ToMs, ct);
             foreach (IGrouping<NodeId, MetricRow> group in all.GroupBy(r => r.AgentId))
             {
-                result[new LineKey(group.Key, new ProbeId(bySeries.Key[RawChunkHeader.LinePrefix.Length..]))] = Decode([.. group]);
+                LineKey key = bySeries.First(l => l.Agent == group.Key);
+                result[key] = Decode([.. group]);
             }
         }
 

backend/src/MoShiro.Backend.Application/Tests/TestService.cs

@@ -28,8 +28,16 @@ public sealed class TestService
         _time = time;
     }
 
-    public async ValueTask<Result<TestRecord>> StartAsync(NodeId agentId, ProbeId probeId, StartTestRequest request, string trigger, CancellationToken ct)
+    public ValueTask<Result<TestRecord>> StartAsync(NodeId agentId, ProbeId probeId, StartTestRequest request, string trigger, CancellationToken ct) =>
+        StartAsync(agentId, probeId, request, trigger, IpVersions.V4, ct);
+
+    public async ValueTask<Result<TestRecord>> StartAsync(NodeId agentId, ProbeId probeId, StartTestRequest request, string trigger, string ipVersion, CancellationToken ct)
     {
+        if (!IpVersions.IsValid(ipVersion))
+        {
+            return ValidationError.Fail<TestRecord>("ip_version", "must be ipv4 or ipv6");
+        }
+
         PlanSpec? plan = Plans.Find(request.Plan);
         if (plan is null)
         {
@@ -47,6 +55,11 @@ public sealed class TestService
             return Result<TestRecord>.Fail(MoShiroErrors.AgentNotActive, "agent is not active");
         }
 
+        if (ipVersion == IpVersions.V6 && !agent.Ipv6Supported)
+        {
+            return Result<TestRecord>.Fail(FleetErrors.Unsupported, "this agent has not enabled IPv6 collection");
+        }
+
         // Agent 在 hello 里声明了它支持的采集方法：方案里有它不支持的就不下发（否则要等到阶段开始才失败）
         string? unsupported = plan.Phases.Select(p => p.Kind).FirstOrDefault(kind => !agent.Kinds.Contains(kind));
         if (unsupported is not null)
@@ -65,7 +78,7 @@ public sealed class TestService
             return Result<TestRecord>.Fail(MoShiroErrors.AgentOffline, "agent is offline");
         }
 
-        if (!(_runtime.TryGet(agentId, out AgentRuntimeState? state) && state.IsConnected(probeId.Value)))
+        if (!(_runtime.TryGet(agentId, out AgentRuntimeState? state) && state.IsConnected(probeId.Value, ipVersion)))
         {
             return Result<TestRecord>.Fail(MoShiroErrors.ProbeOffline, $"probe {probeId.Value} has no session with this agent");
         }
@@ -78,10 +91,10 @@ public sealed class TestService
         var testId = new TestId(Ulid.NewPrefixed(TestId.Prefix, _time));
         long now = _time.GetUtcNow().ToUnixTimeMilliseconds();
         string paramsJson = request.Params is null ? "{}" : JsonSerializer.Serialize(new Dictionary<string, JsonElement>(request.Params), TestJson.Default.ParamMap);
-        var record = new TestRecord(testId, agentId, probeId, plan.Id, paramsJson, trigger, TestStatuses.Queued, null, null, phaseList.Count, now, null, null);
+        var record = new TestRecord(testId, agentId, probeId, plan.Id, paramsJson, trigger, TestStatuses.Queued, null, null, phaseList.Count, now, null, null, ipVersion);
         await _tests.CreateAsync(record, ct);
 
-        Result<bool> sent = await _gateway.RunTestAsync(agentId, new TestRunParams { TestId = testId, ProbeId = probeId, Plan = plan.Id, Phases = phaseList }, ct);
+        Result<bool> sent = await _gateway.RunTestAsync(agentId, new TestRunParams { TestId = testId, ProbeId = probeId, IpVersion = ipVersion, Plan = plan.Id, Phases = phaseList }, ct);
         if (!sent.TryGet(out _, out FleetError? sendError))
         {
             await _tests.UpdateStatusAsync(testId, TestStatuses.Failed, null, sendError.Code.Value, now, ct);
@@ -149,6 +162,8 @@ public sealed class TestService
 
     public ValueTask<IReadOnlyList<TestRecord>> ListAsync(NodeId? agentId, ProbeId? probeId, int limit, CancellationToken ct) => _tests.ListAsync(agentId, probeId, limit, ct);
 
+    public ValueTask<IReadOnlyList<TestRecord>> ListAsync(NodeId? agentId, ProbeId? probeId, int limit, string? ipVersion, CancellationToken ct) => _tests.ListAsync(agentId, probeId, limit, ipVersion, ct);
+
     public static TestResultView ToView(TestResultRecord stored)
     {
         StoredTestMetrics metrics = JsonSerializer.Deserialize(stored.MetricsJson, TestJson.Default.StoredTestMetrics) ?? new StoredTestMetrics();