---
title: "@trigger.dev/sdk 4.8.8: release notes, upgrades and advisories"
description: "@trigger.dev/sdk 4.8.8: release notes, breaking changes by major version and no known security advisory."
url: https://inlinr.com/packages/@trigger.dev/sdk
lang: en
---

[Packages](https://inlinr.com/packages)

# @trigger.dev/sdk

4.8.8 · 20 Nov 2026 MIT 1.7M / week [Repository](https://github.com/triggerdotdev/trigger.dev) [Homepage](https://github.com/triggerdotdev/trigger.dev#readme) [npm](https://www.npmjs.com/package/@trigger.dev/sdk) [Atom feed](https://inlinr.com/packages/feed/@trigger.dev/sdk)

Your version 

## Where each line stands

[Plan an upgrade](https://inlinr.com/packages/@trigger.dev/sdk/upgrade)

LineNewestSecurity

- 4.x 4.8.8 No known advisory Latest line
- 3.x 3.3.17 No known advisory [To 4.8.8](https://inlinr.com/packages/@trigger.dev/sdk/upgrade/3.3.17-4.8.8)
- 2.x 2.3.19 No known advisory [To 4.8.8](https://inlinr.com/packages/@trigger.dev/sdk/upgrade/2.3.19-4.8.8)
- 0.x 0.2.22 No known advisory [To 4.8.8](https://inlinr.com/packages/@trigger.dev/sdk/upgrade/0.2.22-4.8.8)

## Latest releases

[All 180 releases](https://inlinr.com/packages/@trigger.dev/sdk/releases)

1. ### [4.8.8](https://inlinr.com/packages/@trigger.dev/sdk/releases/4.8.8 "Open this release") [](https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.8.8 "Read this release where it was published")  
20 Nov 2026

  - The MCP `list_runs` tool can now filter runs by queue, batch, schedule and bulk action, and its descriptions now say that `period` takes precedence over `from` and `to`.
  - When OIDC token requests are still throttled after retries, `auth.getOIDCToken()` now throws `RateLimitError` with code `RATE_LIMIT_EXCEEDED` for both per-run and shared API limits. If you catch these errors with `instanceof OIDCTokenError`, check for `RateLimitError` instead. Other OIDC errors and retry behavior are unchanged.
  - Stop losing a run's suspend when the supervisor's first attempt to hand it off fails unexpectedly.
2. ### [4.8.7](https://inlinr.com/packages/@trigger.dev/sdk/releases/4.8.7 "Open this release") [](https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.8.7 "Read this release where it was published")  
19 Nov 2026

  - Sessions and `chat.agent` now accept the object form of `concurrencyKey` in `triggerConfig`, giving each concurrency limit its own key, the same as `task.trigger()`.
  - Fix runs failing with `TASK_DID_CONCURRENT_WAIT` on their first wait when `processKeepAlive` is enabled.
  - Fix `chat.agent` channels on AI SDK 7 failing the whole turn when a channel file can't be downloaded. A file the connector owns but can't read is now replaced with an `[Attached file "…" could not be loaded]` note and the agent still answers, as it does on AI SDK 6\. AI SDK 7 describes a file's URL in a tagged form that the SDK didn't recognise, so the failed file was never found.  
  An inline `data:` file in a channel message is no longer passed to a connector's `download`, and on AI SDK 6 it reaches the model instead of failing the turn.
3. ### [4.8.6](https://inlinr.com/packages/@trigger.dev/sdk/releases/4.8.6 "Open this release") [](https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.8.6 "Read this release where it was published")  
18 Nov 2026

  - Allow an explicit audience when signing and verifying JWTs and user-actor tokens.
  - Deploys on the `bun-1.4` runtime now compile the run worker and your task files into a Bun executable with bytecode, so runs start faster. `import.meta.url` and `__dirname` still point at your files under `/app`, so files you read next to your code must be in the image as before (e.g. with `additionalFiles`). Set `build.bunBytecode: false` in `trigger.config.ts` to turn compilation off.
  - `trigger dev` and `trigger deploy` no longer crash with `spawn ... ENOENT` on bun runtimes when Bun isn't installed at `~/.bun`. The CLI now falls back to `bun` on your `PATH` (Homebrew, mise and similar installs), and if Bun still can't be started, `trigger dev` reports a readable error and `trigger deploy` skips local skill discovery with a warning and carries on.

Dependency tracking

## Know when your own dependencies move

@trigger.dev/sdk published 52 releases in the last 12 months. inlinr folds the routine ones into a line and keeps the few that need you.

- Advisories reach you  
An email when a critical or high advisory affects a project, before the next install.
- Upgrades checked first  
Peer ranges, Node, ESM-only and types changes read before you bump.
- Only what matters  
Majors and breaking notes stay; patches and sibling bumps fold into one line.

[How dependency tracking works](https://inlinr.com/dependencies)

## Security

No known security advisory.

## Health

[Details](https://inlinr.com/packages/@trigger.dev/sdk/security#signals)

- **Provenance**:
- **Publisher**:
- **Maintainers**:
- **Scorecard**:
- **Size**:

## Weekly downloads

## Works with

- [zod](https://inlinr.com/packages/zod)
- [ai optional](https://inlinr.com/packages/ai)
- [react optional](https://inlinr.com/packages/react)
- [@ai-sdk/otel optional](https://inlinr.com/packages/@ai-sdk/otel)
- [@aws-sdk/client-sts optional](https://inlinr.com/packages/@aws-sdk/client-sts)

Registry facts last checked 22 Nov 2026\. Releases and advisories last read 22 Nov 2026.

A whole project to check? Paste its package.json in the [dependency check](https://inlinr.com/tools/dependency-check): every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.
