Reduce server console polling load

platform/api/resource_handlers.go

@@ -2441,6 +2441,7 @@ func (h *coreHandlers) jobs(w http.ResponseWriter, r *http.Request) {
 			ServerInstanceID: r.URL.Query().Get("serverInstanceId"),
 			RunEndpointID:    r.URL.Query().Get("runEndpointId"),
 			State:            domain.JobState(r.URL.Query().Get("state")),
+			States:           parseJobStates(r.URL.Query().Get("states")),
 		}
 		var jobs []domain.Job
 		var err error
@@ -2471,6 +2472,20 @@ func (h *coreHandlers) jobs(w http.ResponseWriter, r *http.Request) {
 	}
 }
 
+func parseJobStates(raw string) []domain.JobState {
+	if strings.TrimSpace(raw) == "" {
+		return nil
+	}
+	states := []domain.JobState{}
+	for _, part := range strings.Split(raw, ",") {
+		state := domain.JobState(strings.TrimSpace(part))
+		if state != "" {
+			states = append(states, state)
+		}
+	}
+	return states
+}
+
 // jobCancel godoc
 // @Summary Request job cancellation
 // @Description Records a cancellation request for an accepted or running job; run observes it through the job cancel poll route.

platform/api/resource_handlers_test.go

@@ -86,6 +86,10 @@ func TestCoreAPICreateListDetailWorkflows(t *testing.T) {
 	getJSON[dto.JobResponse](t, router, "/api/v1/jobs/job-1")
 	jobs := getJSON[dto.JobListResponse](t, router, "/api/v1/jobs?serverInstanceId=server-1&runEndpointId=run-local&state=queued")
 	assertListCount(t, jobs.Count, 1)
+	jobs = getJSON[dto.JobListResponse](t, router, "/api/v1/jobs?serverInstanceId=server-1&states=queued,running,failed")
+	assertListCount(t, jobs.Count, 1)
+	jobs = getJSON[dto.JobListResponse](t, router, "/api/v1/jobs?serverInstanceId=server-1&states=running,failed")
+	assertListCount(t, jobs.Count, 0)
 
 	artifactResponse := postJSON[dto.ArtifactResponse](t, router, "/api/v1/artifacts", dto.ArtifactCreateRequest{
 		ID:        "artifact-1",

platform/api/routes.md

@@ -38,6 +38,7 @@ Plugin-owned data is an independent, server-scoped plugin store. It is not a pro
 - `GET /api/v1/metrics/server-instances`
 - `GET /api/v1/run/endpoints?status=online`
 - `GET /api/v1/jobs?serverInstanceId=server-1&runEndpointId=run-local&state=queued`
+- `GET /api/v1/jobs?serverInstanceId=server-1&states=queued,running,failed`
 - `GET /api/v1/artifacts?ownerKind=job&ownerId=job-1&state=uploading`
 - `GET /api/v1/log-streams?serverInstanceId=server-1&streamKey=stdout`