Title: feat: Export RunStatus type from @trigger.dev/sdk · Issue #4051 · triggerdotdev/trigger.dev · GitHub
Open Graph Title: feat: Export RunStatus type from @trigger.dev/sdk · Issue #4051 · triggerdotdev/trigger.dev
X Title: feat: Export RunStatus type from @trigger.dev/sdk · Issue #4051 · triggerdotdev/trigger.dev
Description: Is your feature request related to a problem? Please describe. I may be missing an existing exported type, so please feel free to redirect me if there is already a recommended way to type this. Feature Request It would be useful if @trig...
Open Graph Description: Is your feature request related to a problem? Please describe. I may be missing an existing exported type, so please feel free to redirect me if there is already a recommended way to type this. Fea...
X Description: Is your feature request related to a problem? Please describe. I may be missing an existing exported type, so please feel free to redirect me if there is already a recommended way to type this. Fea...
Opengraph URL: https://github.com/triggerdotdev/trigger.dev/issues/4051
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"feat: Export RunStatus type from @trigger.dev/sdk","articleBody":"### Is your feature request related to a problem? Please describe.\n\nI may be missing an existing exported type, so please feel free to redirect me if there is already a recommended way to type this.\n\n### Feature Request\n\nIt would be useful if `@trigger.dev/sdk` exported the public run status type, for example:\n\n`import type { RunStatus } from \"@trigger.dev/sdk\";`\n\n### Use case example\n\nI am building operational tooling around Trigger. In that context, I need to list runs by status and type status-based logic around `runs.list(...)` and `runs.retrieve(...)`.\n\nFor example:\n\n```ts\nimport { runs } from \"@trigger.dev/sdk\";\nimport type { RunStatus } from \"@trigger.dev/sdk\";\n\nexport async function* listTriggerRunsCreatedBetween(params: {\n createdAtFrom: Date;\n createdAtUntil: Date;\n status?: RunStatus[];\n detailed?: boolean;\n}) {\n\n const listedRuns = runs.list({\n status: params.status,\n from: params.createdAtFrom,\n to: params.createdAtUntil,\n })\n\n for await (const run of listedRuns) {\n yield params.detailed ? await runs.retrieve(run.id) : run;\n }\n}\n```\n\nCurrently, `RunStatus` does not appear to be directly exported from `@trigger.dev/sdk`, so consumers need to derive it indirectly:\n\n```ts\nimport { runs } from \"@trigger.dev/sdk\";\n\ntype Run = Awaited\u003cReturnType\u003ctypeof runs.retrieve>>;\ntype RunStatus = Run[\"status\"];\n```\n\nThese workarounds are usable, but they are less discoverable and couple application code to SDK method signatures rather than to an explicit public SDK type.\n\n### Describe the solution you'd like to see\n\n### Suggested API\n\n`import type { RunStatus } from \"@trigger.dev/sdk\";`\n\n### Describe alternate solutions\n\nOptionally, if the list filter type is intentionally different from the run object status type:\n\n`import type { RunListStatusFilter } from \"@trigger.dev/sdk\";`\n\n### Additional information\n\n### Why this would help\n\nThis would improve TypeScript ergonomics for operational tooling such as run monitoring, ledgers, dashboards, queue inspection, backfills/replays, alerting and guardrails.\n\nIt's a small DX improvement but it would make the SDK easier to use for typed operational workflow.","author":{"url":"https://github.com/olivierbenard","@type":"Person","name":"olivierbenard"},"datePublished":"2026-06-26T08:45:00Z","url":"https://github.com/triggerdotdev/trigger.dev/issues/4051"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react-reconciler,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@d5750093facf |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:e533e7fb-e2de-be6e-b47c-19e11afdf7ef |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C882:18FE1B:A4C621:F4D920:6AFB084C |
| html-safe-nonce | ab4a8f773f5f839842e28682e2029dcf5707dac4fbc626ed0516f933fa1b6363 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDODgyOjE4RkUxQjpBNEM2MjE6RjREOTIwOjZBRkIwODRDIiwidmlzaXRvcl9pZCI6IjI0MjQ5ODQzMzc2MjEzNDA5MiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 50ac580e0d755027e7b2f0e09298f566d2e0c91b875238b1a44c5efa26aa7f7a |
| hovercard-subject-tag | issue:4750635549 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/triggerdotdev/trigger.dev/4051/issue_layout |
| twitter:image | https://opengraph.githubassets.com/481399450c00ca07c40aaa34db8b86b9362d45fd31bc81fb8a70f0348b943cac/triggerdotdev/trigger.dev/issues/4051 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/481399450c00ca07c40aaa34db8b86b9362d45fd31bc81fb8a70f0348b943cac/triggerdotdev/trigger.dev/issues/4051 |
| og:image:alt | Is your feature request related to a problem? Please describe. I may be missing an existing exported type, so please feel free to redirect me if there is already a recommended way to type this. Fea... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | olivierbenard |
| hostname | github.com |
| expected-hostname | github.com |
| None | 76fb13cb43f1834708971f45a9cfcab5df3177a7582086613d7cdc6e98c4bfde |
| turbo-cache-control | no-preview |
| go-import | github.com/triggerdotdev/trigger.dev git https://github.com/triggerdotdev/trigger.dev.git |
| octolytics-dimension-user_id | 95297378 |
| octolytics-dimension-user_login | triggerdotdev |
| octolytics-dimension-repository_id | 572570113 |
| octolytics-dimension-repository_nwo | triggerdotdev/trigger.dev |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 572570113 |
| octolytics-dimension-repository_network_root_nwo | triggerdotdev/trigger.dev |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | afc998826cdd963c8f91a96ae5372809ab5e296b |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width