Packages

@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

Other targets from 4.8.1Newest 4.x, Latest4.8.8
  1. 4.8.1yours
  2. 4.8.2target

Before you upgrade

Tick each one off as you go
  • Breaking4.8.2
  • Breaking4.8.2

Security

  • Upgrade socket.io-client to 4.8.4 so projects using the SDK and CLI install ws 8.21 instead of 8.17.1, which has published advisories (GHSA-96hv-2xvq-fx4p, GHSA-58qx-3vcg-4xpx). The old pin blocked upgrading ws without a package manager override.

    4.8.2

Release by release

  1. 4.8.2

    Security fix29 Oct 202614 new · 12 fixes
    • Security

      Upgrade socket.io-client to 4.8.4 so projects using the SDK and CLI install ws 8.21 instead of 8.17.1, which has published advisories (GHSA-96hv-2xvq-fx4p, GHSA-58qx-3vcg-4xpx). The old pin blocked upgrading ws without 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 clickhouse event store is retired: task events now go to clickhouse_v2. If you self-host with EVENT_REPOSITORY_DEFAULT_STORE=clickhouse, switch it to clickhouse_v2 and 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.

20 other lines we could not sort, mostly version bumps
  • The metrics query 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||s form, 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=true on a supervisor for creates that fail, and RELEASE_FAILED_POD_RUNS_ENABLED=true for pods that fail.

    4.8.2
  • Session external ids can no longer contain a /channels path segment (for example chat-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.

    4.8.2

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.