//! POST /task_workers/filter — returns active background-task workers. //! //! Python contract (`src/prefect/server/api/task_workers.py`): the request //! body is `{"task_worker_filter": {"task_keys": [...]}}` (FastAPI `embed=True` //! wrapper). If task_keys is empty/missing, return all workers. //! //! Response: list of `{identifier, task_keys, timestamp}`. const std = @import("std"); const wap = @import("wap"); const mem = std.mem; const json = std.json; const runtime = @import("../runtime.zig"); const task_workers = @import("../task_workers.zig"); const time_util = @import("../utilities/time.zig"); const TaskWorkerFilterInner = struct { task_keys: ?[]const []const u8 = null, }; const TaskWorkersFilterBody = struct { task_worker_filter: ?TaskWorkerFilterInner = null, }; fn sendError(res: *wap.Response, status: std.http.Status, detail: []const u8) !void { _ = res.setStatus(status); try res.writeJson(.{ .detail = detail }); } pub fn handle(req: *wap.Request, res: *wap.Response) !void { const target = req.path; const method = @tagName(req.method); if (mem.eql(u8, method, "POST") and mem.endsWith(u8, target, "/filter")) { try filter(req, res); return; } try sendError(res, .not_found, "not found"); } fn filter(req: *wap.Request, res: *wap.Response) !void { const alloc = req.arena; // Body shape: {"task_worker_filter": {"task_keys": [...]}}. Empty body or // missing fields = "all workers". var task_keys: []const []const u8 = &.{}; if (req.body.len > 0) { if (req.parseJson(TaskWorkersFilterBody)) |body| { if (body.task_worker_filter) |inner| { if (inner.task_keys) |keys| task_keys = keys; } } else |parse_err| { if (parse_err == error.OutOfMemory) return parse_err; } } const workers = task_workers.snapshotWorkers(alloc, task_keys) catch { try sendError(res, .internal_server_error, "snapshot failed"); return; }; var out: std.Io.Writer.Allocating = .init(alloc); var jw: json.Stringify = .{ .writer = &out.writer }; try jw.beginArray(); for (workers) |w| { try jw.beginObject(); try jw.objectField("identifier"); try jw.write(w.client_id); try jw.objectField("task_keys"); try jw.beginArray(); for (w.task_keys) |k| try jw.write(k); try jw.endArray(); try jw.objectField("timestamp"); var ts_buf: [32]u8 = undefined; const iso = time_util.formatMicros(&ts_buf, w.last_seen_ms * 1000); try jw.write(iso); try jw.endObject(); } try jw.endArray(); _ = res.setHeader("content-type", "application/json"); try res.sendBody(try out.toOwnedSlice()); }