chore: initial project import

backend/src/Monitor.Backend.Application/Ports/IAgentGateway.cs

@@ -0,0 +1,32 @@
+using Fleet.Core;
+using Monitor.Protocol;
+
+namespace Monitor.Backend.Application;
+
+/// <summary>
+/// Application 通往 Agent 连接的端口（由 Gateway 实现）：下发状态变化、发起按需测试、通知 Probe 列表变化。
+/// </summary>
+public interface IAgentGateway
+{
+    IReadOnlyCollection<NodeId> OnlineAgents { get; }
+
+    bool IsOnline(NodeId agent);
+
+    /// <summary>某个 Agent 的期望状态变了：Gateway 重新计算并推送。</summary>
+    void NotifyTaskSetChanged(NodeId agent);
+
+    void NotifyAllTaskSetsChanged();
+
+    /// <summary>Agent 列表变了：通知所有在线 Agent 转发给 Probe。</summary>
+    ValueTask NotifyProbeAgentsChangedAsync(ProbeAgentsResult agents, CancellationToken ct);
+
+    /// <summary>失败时错误码为 <c>probe_offline</c>、<c>test_busy</c>、<c>agent_offline</c> 等。</summary>
+    ValueTask<Result<bool>> RunTestAsync(NodeId agent, TestRunParams run, CancellationToken ct);
+
+    ValueTask CancelTestAsync(NodeId agent, TestId test, CancellationToken ct);
+
+    /// <summary>让 Agent 断开某个 Probe 的会话。返回 Agent 是否真的有这个会话。</summary>
+    ValueTask<Result<bool>> DisconnectProbeAsync(NodeId agent, ProbeId probe, CancellationToken ct);
+
+    ValueTask DisconnectAsync(NodeId agent, string reason, CancellationToken ct);
+}