using System.Text.Json.Serialization;

namespace AgentWorker.WindowsRunner;

// actuate 协议扩展提案：在不动 observe 契约的前提下增加执行类操作。
// 设计原则与 observe 完全一致：单请求单响应、稳定错误码、宿主固定证据根目录。
// 本文件只新增类型；Program.cs 的分发改造见 PATCH-NOTES.md（diff 指引）。
//
// 与 observe 的关键差异（由 RPA 桌面驱动语义决定）：
// 1. Action 携带具体执行参数（坐标/文本/命令），全部字段服务端可审计；
// 2. 坐标一律物理屏幕像素，与 RPA 驱动现状及 CoordinateSpace 契约一致；
// 3. WindowTitle 必须是 AllowedWindows 的精确成员（模糊匹配在 TS 宿主 observe 阶段完成解析），
//    RPA 侧"标题包含匹配"的旧语义不进入原生层。

// 操作闭集：mouse_move / mouse_click / mouse_drag / mouse_scroll / mouse_move_smooth /
// keyboard_send / window_activate / window_set_state / window_set_bounds / window_close。
// 与 observe 相同：模型不能直接指定 HWND；证据目录来自宿主启动参数。
internal sealed record ActuateRequest(
    int ProtocolVersion,
    string RequestId,
    string Operation,
    string WindowTitle,
    DesktopPolicy Policy,
    ActuateAction Action);

// 每个字段都可被逐项审计；不支持的 Kind 由原生层拒绝，不静默降级为观察。
internal sealed record ActuateAction(
    string Kind,
    int? X,
    int? Y,
    int? ToX,
    int? ToY,
    // 滚轮 delta（120 的倍数，负值向下）或窗口 ShowWindow 命令值。
    int? Amount,
    // keyboard_send 文本；上限由 64 KiB 请求预算约束。
    string? Text,
    // keyboard_send 三模式："clipboard"（粘贴）/ "chars"（逐字符）/ "keys"（整段 SendKeys）。
    string? Mode,
    int? IntervalMs,
    bool? Double,
    // "left"（默认）或 "right"。
    string? Button,
    // mouse_move_smooth：false=匀速直线，true/缺省=缓入缓出+抖动。
    bool? Ease,
    // mouse_move_smooth 速度 1-100（默认 35，与 RPA 驱动一致）。
    int? Speed,
    // window_set_bounds 用（x/y 复用 X/Y，Amount 不用）。
    int? Width,
    int? Height,
    int? HoldMs,
    int? ReleaseDelayMs,
    int? SettleMs);

// 动作结果：证据前后各一张，宿主 TS 适配器按 EvidenceRef 逐项复核。
// Data 与 ErrorCode 互斥，与 RunnerResponse 同规则。
internal sealed record ActuateResult(string ActionKind, string CapturedAt,
    ObservedWindow ObservedWindow, IReadOnlyList<EvidenceRef> Evidence, int DurationMs);