v4.6.3
FoundationAgents/MetaGPTv4.6.3Sep 17, 2026by github-actions[bot]
Upgrading?
AI Summary
This release improves error handling by capturing and displaying error cause chains, enhances schedule policy warnings with cron window override guidance, and optimizes model context by keeping summarized assistant steps out of the context after inner compaction.
Key Highlights
- Error cause chains are now captured and shown in dashboard, CLI, and failure alerts.
- Schedule policy warnings now show how to override the default cron window.
- Model context is optimized by excluding summarized assistant steps after inner compaction.
- Error chain is flattened outermost first, capped at five causes, and cycle-safe.
New Features
- Error cause chain visualization
- Cron window override guidance
- Model context optimization
Full Release Notes
# trigger.dev v4.6.3
> [!WARNING]
> A Zod import bug in versions 4.6.0 through 4.6.3 can cause warm starts to fail and delay runs by approximately five minutes when using npm with Zod 3 pinned in `package.json`. Cold starts are unaffected by this bug. No data has been lost.
>
> Redeploy with `npx trigger.dev@latest deploy`, or update your pinned CLI version to **4.6.4 or later** and redeploy. [Read about the fix](https://trigger.dev/changelog/v4-6-4).
## Upgrade
```sh
npx trigger.dev@latest update # npm
pnpm dlx trigger.dev@latest update # pnpm
yarn dlx trigger.dev@latest update # yarn
bunx trigger.dev@latest update # bun
```
Self-hosted Docker image: [`ghcr.io/triggerdotdev/trigger.dev:v4.6.3`](https://github.com/triggerdotdev/trigger.dev/pkgs/container/trigger.dev/1260749993?tag=v4.6.3)
## Release notes
Read the full release notes: https://trigger.dev/changelog/v4-6-3
## What's changed
## Improvements
- Show how to override the default cron window in schedule policy warnings. ([`630eb75d1`](https://github.com/triggerdotdev/trigger.dev/commit/630eb75d1a83a1474d45f155780147ba90cda8e8))
- Thrown error `cause` chains are now captured and shown. When a task throws an error that wraps another one, the run's error in the dashboard, the CLI dev output, and failure alerts all carry the chain instead of only the outermost message. ([`4f36f614b`](https://github.com/triggerdotdev/trigger.dev/commit/4f36f614b7937f9419900bef4080c42cd34b292b))
```ts
throw new Error("Could not sync the customer", { cause: originalError });
```
The chain is flattened outermost first, capped at five causes, and cycle safe. It also rides on the `error` of API and realtime run records as a `causes` array, and `triggerAndWait` and `triggerAndSubscribe` rebuild it as a native `cause` on the error they hand back, so `err.cause` works in your own catch blocks.
- Keep summarized assistant steps and tool results out of future `chat.agent()` model context after inner compaction, while preserving the full visible conversation. ([`fc77bfc9a`](https://github.com/triggerdotdev/trigger.dev/commit/fc77bfc9a2005159b64f0f51777f4ab8e79ba6a9))
## All packages: v4.6.3
@trigger.dev/build, @trigger.dev/core, @trigger.dev/python, @trigger.dev/react-hooks, @trigger.dev/redis-worker, @trigger.dev/rsc, @trigger.dev/schema-to-json, @trigger.dev/sdk, trigger.dev
## Contributors
Chris Arderne, Wes Mason, Eric Allam, github-actions[bot], @Mariefay, Matt Aitken, @d-cs
**Full changelog**: https://github.com/triggerdotdev/trigger.dev/compare/v4.6.2...v4.6.3
Related Repositories
public-apis/public-apis★ 491,191
A collective list of free APIs
NousResearch/hermes-agent★ 256,048
The agent that grows with you
yt-dlp/yt-dlp★ 200,222
A feature-rich command-line audio/video downloader
microsoft/markitdown★ 191,542
Python tool for converting files and office documents to Markdown.
Significant-Gravitas/AutoGPT★ 187,700
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.