@trigger.dev/sdk
4.8.8 · 20 Nov 2026MIT1.7M / weekRepositoryHomepagenpmAtom feed
Upgrading @trigger.dev/sdk From 4.8.1 to 4.8.2
1 release in betweenevery note read
- 2
- changes to make
- 0
- advisories fixed
- 14
- new
- 12
- fixes
Before you upgrade
Tick each one off as you go- Breaking4.8.2
- Breaking4.8.2
Security
- 4.8.2
Upgrade
socket.io-clientto 4.8.4 so projects using the SDK and CLI installws8.21 instead of 8.17.1, which has published advisories (GHSA-96hv-2xvq-fx4p, GHSA-58qx-3vcg-4xpx). The old pin blocked upgradingwswithout a package manager override.
Release by release
- Security
Upgrade
socket.io-clientto 4.8.4 so projects using the SDK and CLI installws8.21 instead of 8.17.1, which has published advisories (GHSA-96hv-2xvq-fx4p, GHSA-58qx-3vcg-4xpx). The old pin blocked upgradingwswithout a package manager override. - Breaking
Query dashboard APIs reject run tokens and public access tokens without user delegation. Existing API key access, including restricted keys with the required query scopes, is unchanged. MCP dashboard access remains supported through delegated tokens for current organization members.
- Breaking
The legacy
clickhouseevent store is retired: task events now go toclickhouse_v2. If you self-host withEVENT_REPOSITORY_DEFAULT_STORE=clickhouse, switch it toclickhouse_v2and follow the self-hosting guide to copy older events, which no longer show until you do. - New
Deployed tasks now keep a valid short-lived run token for their whole run: the token is refreshed during long runs and before a run resumes from a checkpoint. A warm-started task no longer keeps the previous run's token when the next run has none, and run credentials are left out of runner debug logs.
- Security
20 other lines we could not sort, mostly version bumps
- 4.8.2
The
metricsquery table now includes queue size (queue.size.*) and webhook limit metrics (webhook.waiters.*,webhook.processing.*,webhook.ingress.*), so you can chart and alert on queue capacity and webhook rate limits. - 4.8.2
Expand short-lived run-token support to task APIs, with permission checks for packets, metadata, streams and waits. Run tokens last one hour independently of root-key rotation and cannot be individually revoked. They can mint public access tokens for up to 30 days; those tokens may outlive the run token that minted them.
- 4.8.2
Hosted webhook endpoints can verify ECDSA P-384 (SHA-384) signatures, ECDSA signatures in raw
r||sform, and RSA signatures made over a SHA-256 digest of the signing string (prehash: "sha256"). - 4.8.2
Older runs now load their trace, span details and run events faster. A span that finishes more than a week after its run shows as still in progress.
- 4.8.2
The run page now loads large traces progressively and updates live runs incrementally, so big traces open faster and open run pages no longer reload the whole trace while a run is executing. The run trace API can also page large traces.
- 4.8.2
Query alerts now accept queries whose columns are computed from other aggregate columns, such as a percentage of two aggregates. When a query can't be watched, the Watch button stays visible but disabled and explains why.
- 4.8.2
Archiving unused queues from the Concurrency page is now available on all instances, including self-hosted.
- 4.8.2
Runs whose container or pod could not be created, or whose pod failed before the run started, can now be requeued straight away instead of waiting for the pending execution timeout. Both are off by default: set
RELEASE_UNSTARTED_RUNS_ENABLED=trueon a supervisor for creates that fail, andRELEASE_FAILED_POD_RUNS_ENABLED=truefor pods that fail. - 4.8.2
Session external ids can no longer contain a
/channelspath segment (for examplechat-1/channels/support) or end in:channels, since both forms name a session's channels. Creating a session with one now returns a 422 validation error. - 4.8.2
Selecting a span that started a session now shows a link to that session in the span panel, so you can jump from an orchestrator's run to its sub-agents.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.