Packages

@trigger.dev/sdk

4.8.8 · 20 Nov 2026MIT1.7M / weekRepositoryHomepagenpmAtom feed

Upgrading @trigger.dev/sdk From 4.8.4 to 4.8.8

4 releases in betweenevery note read

  1. 4.8.4yours
  2. 4.8.5security
  3. 4.8.6
  4. 4.8.7
  5. 4.8.8target
0
changes to make
0
advisories fixed
24
new
13
fixes

Security

  • Deployed tasks on the node, node-22, node-24 and node-26 runtimes now run on Node.js 22.23.5, 24.22.3 and 26.13.1, the November 2026 security releases. They fix several high severity issues in HTTP/2 and TLS, including CVE-2026-123863, CVE-2026-123864, CVE-2026-123865, CVE-2026-123866, CVE-2026-123872 and CVE-2026-123874, plus CVE-2026-126051 on Node.js 24 and 26. Existing deployments keep the old runtime until you redeploy with this version.

    4.8.5

Release by release

  1. 4.8.8

    20 Nov 20263 new
    • New

      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.

    • New

      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.

    • New

      Stop losing a run's suspend when the supervisor's first attempt to hand it off fails unexpectedly.

  2. 4.8.7

    19 Nov 20261 new · 6 fixes
    • New

      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().

    • Fixed

      Fix runs failing with TASK_DID_CONCURRENT_WAIT on their first wait when processKeepAlive is enabled.

    • Fixed

      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.

    • Fixed

      Fix two compaction problems on AI SDK 7. After a compaction, a chat.agent turn that continued a tool approval sent the model the full pre-compaction transcript instead of the summary, which undid the compaction (this also affected chat.MessageAccumulator). And between-turn compaction, in chat.agent and chat.createSession, was asked about the whole turn's token usage instead of the last step's, so shouldCompact thresholds triggered too early on multi-step turns.

    • Fixed

      Fix chat.agent steering on AI SDK 7. A steering message that pendingMessages.prepare turns into a system message no longer makes the step fail with an invalid-prompt error: chat.toStreamTextOptions() now sets allowSystemInMessages: true, as AI SDK 5 and 6 already behave (pass allowSystemInMessages: false after the spread to keep AI SDK 7's strict default). A turn whose stream ends on an error now reports finishReason: "error" in onTurnComplete, where it could be undefined or the previous step's reason.

    • Fixed

      Fix a chat.agent tool result containing a BigInt failing the next turn's model call in apps that define BigInt.prototype.toJSON. It is now sent as the JSON that toJSON gives, in the next step and in later turns.

    • Fixed

      Fix chat.agent failing the next step or turn with AI_InvalidPromptError ("The messages do not match the ModelMessage schema") when a tool returned a value that isn't plain JSON, such as a Date from an ORM row. On AI SDK 6, and AI SDK 7 before 7.0.101, tool results are now converted to JSON the way newer AI SDK versions do it, so a Date reaches the model as its ISO string. A value JSON can't hold, such as a BigInt or a circular reference, is replaced by an error result that names the tool and the field, and the same error is logged on the run.

  3. 4.8.6

    18 Nov 202620 new · 7 fixes
    • New

      Allow an explicit audience when signing and verifying JWTs and user-actor tokens.

    • New

      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.

    • New

      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.

    • New

      Bundled task files now keep their project layout (for example /app/src/trigger/tasks.mjs) when the CLI runs from outside the project, such as npx trigger.dev deploy. Before, they could land under a path containing the project's location, away from the files additionalFiles copies next to them, so reads relative to import.meta.url failed.

  4. 4.8.5

    Security fix12 Nov 2026
    • Security

      Deployed tasks on the node, node-22, node-24 and node-26 runtimes now run on Node.js 22.23.5, 24.22.3 and 26.13.1, the November 2026 security releases. They fix several high severity issues in HTTP/2 and TLS, including CVE-2026-123863, CVE-2026-123864, CVE-2026-123865, CVE-2026-123866, CVE-2026-123872 and CVE-2026-123874, plus CVE-2026-126051 on Node.js 24 and 26. Existing deployments keep the old runtime until you redeploy with this version.

42 other lines we could not sort, mostly version bumps
  • The remote MCP server can now list the tags used on your runs, search and read your logs, add tags, update metadata, reset idempotency keys and reschedule delayed runs, and run details now include the run's metadata values. It can also list, read, create and abort bulk actions that cancel or replay many runs at once, and you approve every bulk action it creates. It can also read what a run streamed. Edits that would change nothing are refused without asking you to approve them.

    4.8.8
  • The dashboard now shows only the last four characters of root API keys for all projects. Existing root keys still work, but you can no longer copy them from the dashboard. Create a separate API key for each new integration.

    4.8.8
  • The remote MCP server now offers new OAuth scopes for errors, queues, tasks, batches, waitpoints, environments, deployments, branches, environment variable names and project settings. Existing connections keep the access they already have.

    4.8.8
  • External OIDC token requests now count against the same environment rate limit as other API requests, with the per-run limit unchanged.

    4.8.8
  • A run's Session link now opens the session at that run.

    4.8.8
  • Reopening the time filter keeps an exact date range selected instead of switching back to "in the last".

    4.8.8
  • Worker registration now refuses task source files that are too large once decompressed or aren't valid text, with an error that names the file.

    4.8.7
  • The session page now says when earlier conversation messages couldn't be loaded, with a retry, and closing a session keeps the view you were on.

    4.8.7
  • On a live run's trace, "Errors only" and search now pick up a span that fails or gets a new name after it first appeared.

    4.8.7
  • Alert webhook URLs that point at private or reserved network addresses are now rejected in more cases.

    4.8.7

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.