feat(webapp,core,cli): filter runs by region in dashboard, API, and MCP

[ericallam]

Summary

Adds a Region column and Region filter (under More filters) to the runs list dashboard, the same filter on the public runs list API (filter[region]), and a matching region input on the MCP list_runs tool. Each run's executing region is also surfaced as a new optional region field on the runs list and run retrieve responses, populated from the worker instance group's masterQueue identifier.

Useful when you run tasks across multiple regions and want to slice the runs list — or your existing run-querying scripts — by where the run actually executed.

Design

The filter value in the URL / API is the masterQueue identifier (the same string already persisted on TaskRun and replicated to ClickHouse as worker_queue), so the query just becomes worker_queue IN (...) with no server-side translation. The Region dropdown options come from a new resource loader backed by RegionsPresenter, which now also exposes masterQueue alongside the existing region metadata.

// public API
const runs = await runs.list({ region: ["us-east-1", "eu-west-1"] });
// each item: { id, status, ..., region?: "us-east-1" }

// MCP
list_runs({ environment: "prod", region: "us-east-1" })

Test plan

• Dashboard: open the runs list, confirm the new Region column renders the friendly region name (or – for legacy runs with empty masterQueue).
• Dashboard: open More filters → Region, multi-select a couple of regions, confirm the URL gains ?regions=<masterQueue> and the list narrows.
• Combine with Queues / Statuses / time filters — no interaction regressions.
• API: GET /api/v1/runs?filter[region]=<masterQueue> returns only matching runs, and each item has a region field set.
• API: GET /api/v1/runs/<id> returns region for a run that has a non-empty workerQueue.
• MCP: call list_runs with region: "..."; verify the formatted output line includes region:<value>.

---

This is part 1 of 5 in a stack made with GitButler:

•  5  feat(webapp,core,cli): filter runs by region in dashboard, API, and MCP #3612 👈
•  4  feat: ai-chat reference project + MCP agent-chat tooling (4/4) #3546
•  3  feat(webapp): agent-view dashboard for chat.agent runs (3/4) #3545
•  2  feat(sdk): chat.agent — runtime + browser transport (2/4) #3543
•  1  feat: Sessions dashboard, task_kind, and chat-ready hardening (1/4) #3542

[changeset-bot]

🦋 Changeset detected

Latest commit: aac03ef

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 32 packages

Name	Type
trigger.dev	Patch
@trigger.dev/core	Patch
@trigger.dev/sdk	Patch
references-ai-chat	Patch
d3-chat	Patch
references-d3-openai-agents	Patch
references-nextjs-realtime	Patch
references-realtime-hooks-test	Patch
references-realtime-streams	Patch
references-telemetry	Patch
@trigger.dev/build	Patch
@trigger.dev/plugins	Patch
@trigger.dev/python	Patch
@trigger.dev/redis-worker	Patch
@trigger.dev/schema-to-json	Patch
@internal/cache	Patch
@internal/clickhouse	Patch
@internal/llm-model-catalog	Patch
@trigger.dev/rbac	Patch
@internal/redis	Patch
@internal/replication	Patch
@internal/run-engine	Patch
@internal/schedule-engine	Patch
@internal/testcontainers	Patch
@internal/tracing	Patch
@internal/tsql	Patch
@internal/zod-worker	Patch
@internal/sdk-compat-tests	Patch
@trigger.dev/react-hooks	Patch
@trigger.dev/rsc	Patch
@trigger.dev/database	Patch
@trigger.dev/otlp-importer	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 164cbbfe-797b-4490-bce1-a93f75f5fa43

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/runs-list-region-filter

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}